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S (54) Title: MODIFIED MOVE TO REAR LIST SYSTEM AND METHODS FOR THREAD SCHEDULING 

(57) Abstract: Methods and systems for scheduling threads in a 
multi-threaded computer system use a modified move-to-rear list 
scheduling algorithm. Threads are ordered in a service list accord- 
ing to a virtual time value. System threads always retain a virtual 
time value. For system threads, the virtual time value serves as a 
priority. For user threads, the virtual time value is incremented af- 
ter the thread has received a share of access tote CPU resource. 
The invention can provide soft real time capability for applica- 
tion software. At the same time, it satisfies system threads which 
must be exccuied with some urgency. The thread scheduler of the 
invention may be used to advantage in the Java multi-mreading 
framework. 
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MODIFIED MOVE TO REA R LIST SYSTEM 
AND METHOPS FQK IBBEAD SCHEDULING 

Technical Field 

This invention relates to scheduling of threads in a multi- 
threaded computer system. The invention has particular application to 
managing CPU resources on the JAVA platform. 

ftfrckground 

Modern general purpose computers make it possible to provide 
a wide variety of applications which are multimedia in nature. A multimedia 
application must be run on an underlying supporting environment which can 
properly support the delivery of continuous media data. Otherwise the 
multimedia application will not be presented in a satisfactory way. Real-time 
requirements are imposed on the host operating system and its subsystems 
because continuous media data, such as digital audio or digital video, must 
be presented continuously at a predetermined rate in order to correctly 
represent the information being carried. The requirements on the operating 
system may be classified as being "soft real-time" because, in general, the 
operating system is only required to statistically guarantee that quality of 
service parameters, such as delay and throughput, will be maintained. 
Multimedia applications often have deadlines for completing various tasks. 
Fortunately, missing a particular deadline is generally not fatal as long as 
the deadline is not missed by too much and as long as most other deadlines 
are not missed. 

Multimedia applications are typically very resource intensive. 
A supporting computer platform must be able to partition, monitor and police 
the usage of system resources so that all current application programs can 
make adequate progress, even in the presence of heavy system loads. 

One platform that has several desirable characteristics for 
multimedia computing is the Java platform. In the Java platform, 
application software written in the Java programming language runs on top 
of a Java language programming environment. The Java language 
programming environment includes a Java operating system. The Java 
operating system rims either on computing hardware which includes a Java 
processor which directly interprets Java language commands (sometimes 
known as Java on Java) or on conventional general purpose computing 



WO 01/3520? 



-2- 



PCT/CA00/01339 



hardware running an operating system, such as Windows NT or UNIX, and 
a software Java processor emulator (also known as a Java virtual machine) 
running on the operating system, 

5 Programmers write applications for the Java platform within 

the Java language programming environment. The Java programming 
language has a number of advantages. It is small and easily-understood to 
programmers, Java is object oriented, has built-in support for multi-threaded 
programming and has automatic memory management. Java is portable, 

10 dynamic and robust. In addition an extensive collection of software libraries 
including Java class libraries and OS specific "native" libraries is available 
to programmers. The fact that a wide selection of software libraries is 
available facilitates the rapid development of a wide variety of applications 
including multimedia processing applications. The interpreted nature of J ava 

15 enables Java applications to run on a wide variety of computer hardware and 
a wide variety of operating systems without modification. 

A problem with implementing multimedia applications on Java 
platforms is that Java presently does not provide support for real-time 
20 processing. Java does not provide any mechanism which can be used to 
monitor, manage or police the usage of the CPU resource to ensure the proper 
delivery of continuous media data. Current implementations of Java use a 
static priority-based algorithm for thread scheduling. Such algorithms have 
been shown to be largely ineffective for multimedia applications. 

25 

A further problem is that the J ava product specification does not 
specify how thread scheduling should be implemented. Different thread 
scheduling mechanisms are used by various Java virtual machines. This 
leads to inconsistencies across platforms and can cause Java applications 
30 which function properly on one platform to not function properly on other 
platforms. 

Nilsen AddingRealTime Capabilities to Java . Commimications 
of the ACM, 41(6):49-56, 1998 proposes certain extensions to the Java 
35 environment which are designed to facilitate real-time computing. The 
Nilsen system relies on an off-line analyzer and scheduler to provide 
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information to a real-time executive for deterministic execution. The Nilsen 
system is not fully compatible with the Java reference implementation and 
requires applications to be modified and specifically optimized. The Nilsen 
system is therefore not useful for general purposes. 

5 

Sxm Microsystems has recently proposed a real-time extension 
to the Java platform. The proposed extension relies on static priority-based 
scheduling and exploits real-time facilities in underlying real-time operating 
systems. Unfortunately, hard real-time scheduling based upon static 
10 priorities has been shown to be inefficient for running soft real-time 
multimedia applications. 

Various algorithms suitable for scheduling threads in multi- 
threaded computer systems are known. Many of these algorithms were 

15 developed for scheduling packets in packet switched networks and were 
subsequently adapted for use in scheduling threads in multi threaded 
computer systems. For example, weighted fair queuing (WFQ) computes start 
and finish times for each entity being scheduled and schedules the entities 
in increasing order of their finish times. The need to compute finish times 

20 makes WFQ very computationally intensive. Furthermore, WFQ does not 
provide fairness when the available bandwidth fluctuates over time due to, 
for example, sporadic interrupt processing. 

Fair queuing based on start time (FQS) is similar to WFQ but 
25 schedules entities in increasing order of their start times. FQS is also 
computationally expensive and does not provide fairness when available 
bandwidth fluctuates. 

Self clocked fair queuing (SCFQ) functions in a similar manner 
30 to WFQ but uses an approximation to calculate the finish times for each 
entity. SCFQ is quite efficient. Unfortunately, SCFQ achieves efficiency at 
the expense of a maximum scheduling delay which may be unacceptable for 
many applications, especially multimedia applications. 

35 The start time fair queuing (SFQ) algorithm assigns start and 

finish tags to each entity to be scheduled and then schedules the entities in 



WO 01/35209 PCT/CAO0/OI339 



increasing order of their start tags. A disadvantage ofSFQ is that its delay 
bound increases linearly with the number of threads in the system. Thus it 
is not ideal for a general purpose environment in which the number of 
threads may vary. 

5 

The experimental Plan 9 operating system incorporates a new 
scheduling algorithm called Move to Rear List Scheduling (MTR-LS). Move 
to rear scheduling is described in J. Bruno et aL, Move-To-Rear List 
Scheduling: a new scheduling algorithm for providing QoS guarantees. 

10 Proceedings of the Fifth A CM International Multimedia Conference, pp. 63- 
73, November 9-13, 1997. The MTR-LS algorithm assigns a weight, called 
a service fraction, to each thread. The service fraction specifies the minimum 
amount of the CPU resource to be allocated to the thread in absolute terms 
as a fraction of the total available CPU resource. Each thread is also 

1 5 assigned a time stamp. Scheduling of threads is based on their time stamps. 
The time stamps are adjusted according to the service fractions of their 
respective threads and the amount of CPU resources consumed by the 
threads. In addition to the normal QoS guarantees, MTR-LS can provide a 
"cumulative service guarantee**. 

20 

A disadvantage of the MTR-LS algorithm is that it cannot 
effectively be used to schedule system threads which use priorities to specify 
their urgency. In a priority-based system, the system thread that services 
timers and clock interrupts can be given a priority higher than that of any 

25 other threads in the system. In such a priority-based system the scheduler 
can pre-empt the current thread and schedule the timer and clock service 
thread as soon as the timer and clock service thread becomes runnable. With 
a move to rear list scheduling algorithm it is not possible to express the 
relative urgency of different threads since each thread is merely guaranteed 

30 a share of the CPU resource but threads are otherwise equal in priority. 

There is a need for systems and methods for scheduling threads 
in multi-threaded computer systems which provide fairness and quality of 
service guarantees, and yet retain the ability to effectively schedule system 
35 threads which must be executed with some urgency. There is a particular 
need for such systems and methods which can be applied to the Java 



WO 01/35209 PCT/CA00/01339 

-5- 



operating system because the Java operating system is otherwise well 
adapted for use in multimedia applications. 

Summar y of the Invention 
5 This invention provides systems and methods which use a 

modified move to rear list scheduling algorithm. In the modified move to 
rear list scheduling algorithm each thread is assigned a timestamp value. 
For high priority system threads the timestamp value is set so that it is 
always earlier than timestamp values for most other threads. In preferred 

10 embodiments the timestamp values for system threads are static. The time 
stamp values for low priority system threads, such as idler threads are set 
so that they are always later than the time stamp values of most other 
threads. The value of the timestamp for the high priority system threads 
indicates a high priority with which the system threads should be executed 

15 if they are ready to rim. Conversely, the time stamps of low priority system 
threads indicate a low priority. All user threads have time stamps that are 
between those of the high priority system threads and the low priority 
system threads. For user threads, the timestamp value is reassigned each 
time the thread uses up an amount of the CPU resource which has been 

20 allocated to the thread. 

One aspect of the invention provides a computer implemented 
method for scheduling the running of threads in a multi-threaded computer 
system. The method comprises maintaining a list of a plurality of threads, 

25 each having a timestamp value. A scheduler identifies, as the current 
thread, the thread which has the earliest timestamp value of any threads 
which are ready to run. The method maintains a time left value for each 
thread. If the time left value for the current thread indicates that the thread 
has some time left to run then control is transferred to the current thread for 

30 a running time not exceeding the time left value for the current thread. After 
the current thread has run for the running time, if the current thread is not 
a system thread, then the running time is subtracted from the time left value 
for the thread. Whenever the time left value for the current thread is not 
greater than zero, the current thread is assigned a new timestamp value 

35 which is greater than the timestamp values of any of the other user threads. 
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The time left value for the current thread is then re-initialized as described 
below. 

The methods of the invention permit the fair scheduling of 
5 threads while enabling system threads to be scheduled in a manner which 
takes into account the urgency of the system threads relative to other system 
threads and user threads. 

Another aspect of the invention provides a multi-threaded 

10 computer system which implements modified move to rear list thread 
scheduling. The computer system includes: a processor; and a multi- 
threaded operating system running on the processor. The operating system 
comprises a plurality of system threads. User software on the computer 
system comprises one or more user threads. The system includes a memory 

1 5 accessible to the processor. The memory contains a data structure comprising 
a record for each of a plurality of threads. The plurality of threads comprising 
at least one high priority system thread and the one or more user threads. 
Each record includes a timestamp value, a service fraction value and a time 
left value for the thread corresponding to the record. The computer system 

20 includes a scheduler which is adapted to identify as a current thread one of 
the plurality of threads which is ready to run and has a timestamp value 
earlier than the timestamp value of any other of the plurality of threads 
which is ready to run. If the time left value for the current thread is greater 
than zero, the scheduler transfers control of the processor to the current 

25 thread for a running time not exceeding the time left value for the current 
thread; and, if the current thread is not a system thread, the scheduler 
subtracts the running time from the time left value for the current thread. 
If the time left value for the current thread is not greater than zero then the 
scheduler assigns a new timestamp value to the current thread, the new 

30 timestamp value being later than the timestamp values of any of the user 
threads. The scheduler then initializes the time left value of the current 
thread and selects a new current thread. 

Further aspects, advantages and inventive features of the 
35 invention are described below. 



WO 01/35209 



WO 01/35209 PCT/CAOO/01339 

-7- 

Brief Description of Drawings 

In drawings which illustrate non-limiting embodiments of the 

invention: 

Figure 1A is a schematic view of a conventional prior art computing 
5 environment; 

Figure IB is a schematic view of a prior art Java computing 
environment incorporating a Java virtual machine running in a conventional 
computing environment; 

Figure 1C is a schematic view of a prior art Java environment 
10 including Java software running on a computing hardware which includes 
a Java processor; 

Figure 2 is a schematic view of a computer system according to the 
invention; 

Figure 3 is a service list for use in systems and methods according to 
15 the invention; 

Figure 4 is a flowchart illustrating a method according to the 
invention; 

Figure 5 is a diagram illustrating the assignment of a new timestamp 
value to a user thread in the method of the invention; and, 
20 Figure 6 is a block diagram illustrating functional units of a computer 

system which includes a modified MTR-LS thread scheduler according to the 
invention. 

Description 

25 Figure 1A illustrates a conventional computing environment in 

which an operating system runs on computer hardware. The computer 
hardware incorporates one or more processors and provides other resources 
which may be used by applications. The resources may include memory, 
access to peripheral devices, and so on. A programming environment 

30 mediates interactions between application software and the operating system 
and interactions between application software and the computer hardware. 
The application software runs in the programming environment. A problem 
which has been recognized with the conventional computing environment is 
that application software must be written specifically for each programming 

35 environment since not all programming environments provide the same 
resources for use by application programs. 
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Figure IB shows a prior art Java computing environment. An 
operating system runs on suitable computing hardware. The operating 
system may be, for example, Microsoft Windows™ or Sun Solaris™. A Java 
processor emulator (known as a Java Virtual Machine or "JVM") runs on the 
5 operating system. A Java operating system runs on the Java processor 
emulator. The Java operating system provides resources to a Java language 
environment. Java application software runs in the Java language 
environment. Commands which make up the Java application are received 
by the Java operating system and interpreted by the Java processor 

10 emulator. The Java operating system and processor emulator, in turn, cause 
the operating system and/or hardware to implement the commands. One 
advantage of the JAVA language environment is that the JAVA language 
environment is standardized so that every JAVA language environment 
provides the same resources to JAVA applications without regard to the 

15 computing hardware on which the JAVA language environment is provided. 

Figure 1C shows an alternative Java computing environment 
which includes a JAVA processor. A JAVA processor is a microprocessor that 
is capable of executing directly Java instructions (called "byte codes"). When 
20 such a processor is available, the Java operating system and progr am m i ng 
environment can be written in the Java language and executed on the 
processor directly. This eliminates the need for a general purpose operating 
system and saves much overhead. 

25 The following description explains an embodiment of the 

invention which provides thread scheduling in a Java computing 
environment, such as the environment shown in either of Figures IB or 1C. 
The invention has particular application to this environment but the 
methods and systems of the invention may be used for thread scheduling in 

30 multi-threaded computer systems generally. 

Figure 2 shows a computer system 20 according to the 
invention. System 20 has a processor 22, a memory 24 accessible to 
processor 22, and application software 26, which includes a plurality of 
35 threads containing instructions to be executed by processor 22. System 20 
also includes a software programmable system timer 28 and JAVA operating 
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system software 30 which includes a scheduler 32 which schedules the 
running of threads of application software 26. 

For each active thread, JAVA operating system software 30 
5 maintains a record in a data structure 34 in memory 24, Data structure 34 
maintains information about the thread. The form of data structure 34 is 
not particularly important. Data structure 34 may include information such 
as the name of the thread; a pointer to stack memory for the thread; a 
program counter; a register file; machine context information; and a pointer 

10 to a parent process as is known in the art. In addition, data structure 34 
includes, for each thread, fields for a timestamp value, a service fraction 
value and a time left value. JAVA operating system 30 also maintains a 
service list 40, which contains a list of all active threads. Service list 40 is 
used by scheduler 32 to schedule threads, as described below. In preferred 

15 embodiments of the invention, JAVA operating system 30 maintains a queue 
42 which contains a list which includes entries for all active threads which 
are ready to run. 

In a computer system 20 according to the invention various 
20 types of threads share processor 22. Processor 22 must service high priority 
system threads. Such threads must be serviced with a high priority for 
proper operation of computer system 20. An example of a high priority 
system thread is the thread which services a system clock interrupt and 
services timeouts generated by timer 28. A second group of threads is the 
25 group of threads which make up running user application software 26. Such 
threads may be called "user threads". The programmers of application 
software 26 may wish to control how much time processor 22 spends 
servicing various ones of the user threads. Threads which require large 
amounts of the processor resource may be given more time to run on 
30 processor 22 than other less computationally intensive threads. Finally, 
computer system 20 may include a number of low priority system threads 
which perform functions such as running the finalizeO routines of discarded 
JAVA objects or performing garbage collection routines. 



35 As noted above, data structure 34 includes a timestamp value 

for each thread. As illustrated in Figure 3, threads in each different group of 
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threads are assigned timestamp values in a different range. Figure 3 is a 
map of all possible timestamp values. In the preferred embodiment of the 
invention, the space of possible timestamp values is subdivided into four 
ranges, a high priority system thread space 44, a user thread space 46, a low 
5 priority system thread space 48, and a reserved space 50. The user thread 
space 46 is typically much larger than any of the other thread spaces. 

High priority system threads are assigned timestamp values 
from high priority system thread space 44. Since any practical computer 
10 system will have a limited number of high priority system threads, high 
priority system thread space may include a relatively small number of 
timestamp values. In the preferred embodiment of the invention a clock 
handler thread is assigned an earliest timestamp of all and a time sheer 
thread is assigned the next earliest timestamp. 

15 

User threads are assigned timestamps in the range 46. Low 
priority system threads may be assigned timestamps in the area 48. The 
reserved space 50 is preferably left available for various system tasks, as 
described below. 

20 

The timestamp values assigned to threads are not directly 
connected to the time as measured by any clock but are numbers. Smaller 
numbers may be associated with "early" timestamps and larger numbers 
with 'later" timestamps or vice versa. Preferably the timestamp is 
25 represented as an integer which permits the timestamp value to have a very 
large range of values. For example, a 64-bit integer may be used to represent 
the timestamp value. In general the timestamp value is preferably an 
integer of 45-bits or more. 

30 The active threads in service list 40 can be conceptually 

arranged in order of their timestamp values, from earliest to latest. The 
position of each active thread in such an ordered service list 40 is determined 
by the timestamp values for the thread. Threads having earlier timestamps 
(it can be appreciated that "earlier" may be represented by a higher or lower 

35 values of the timestamp) appear near the head of service list 40 (i.e. toward 
high priority system area 44). Threads having later timestamps appear 
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farther toward the rear of service list 40. Each thread has a service fraction 
value which indicates how much of the processor's time should be allocated 
to processing instructions in that thread. 

5 It is not necessary to keep the entries in service list 40 ordered 

by timestamp value since, at any given time, a large number of threads will 
not be ready to rim. At any given time there will be a large number of active 
threads which are not ready to run. For example, threads may be waiting for 
a resource, such as a printer, a disk drive, or some other peripheral to become 

10 available; threads may be waiting for other threads to complete certain 
operations or to supply certain results; and/or threads may be waiting for 
another thread to leave a monitor. Scheduler 32 is only required to schedule 
threads which are ready to run. Preferably scheduler 32 maintains in queue 
42 a list of threads which are ready to run wherein threads with earlier 

15 timestamps are closer to the head of queue 42 than are threads which have 
later timestamps. Queue 42 preferably employs a heap data structure for 
efficiency. 

As shown in Figure 4, a method 100 for scheduling threads 
20 according to the invention begins by identifying a current thread (Step 1 10) . 
The current thread is the thread in queue 42 which has a timestamp which 
is earlier than the timestamps of any other threads in queue 42. Where 
threads in queue 42 are sorted in order of timestamp as described above then 
scheduler 32 can then be implemented by simply selecting the first thread 
25 in the ready to run queue as the current thread. 

System threads are handled differently from user threads. 
Scheduler 32 determines if the selected thread is a system thread (step 112). 
If the thread identified as the current thread is a system thread then timer 

30 28 is set to measure an interval which determines how long the system 
thread will be permitted to run (Step 114). Typically the interval is set to 
equal either a preemption interval or the value of time left specified in data 
structure 34 for the system thread, whichever is lower. Scheduler 32 then 
transfers control to the current system thread (Step 116) and the current 

35 system thread is allowed to run (step 117) until timer 28 times out or the 
current system thread voluntarily relinquishes control over processor 22. 
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Method 100 then returns to Step 1 10 to identify a new current thread, which 
may he the same as or different from the thread which has just executed. The 
time left value for system threads is not altered. 

5 Each time a naming thread is suspended, context switching 

code, which is included in scheduler 32, temporarily disables any further 
signals, calculates the CPU resource consumption for the running thread 
since the context was switched to it and saves the context of the running 
thread. 

10 

If the current thread is not a system thread then a 
determination is made at Step 118 as to whether or not the time left value 
for the current thread is greater than zero. If the time left value is greater 
than zero then the start time of the thread is recorded and timer 28 is set to 

15 time out after an interval determined by the shorter of the preemption 
interval and the time left value for the current thread (Step 120). Once 
again, timer 28 measures an interval which determines the maximum 
amount of time that the thread will have to execute without interruption. 
Each time a user thread begins to run, context switching code records the 

20 start time of the thread. 

Method 100 then transfers control to the current user thread 
(Step 122) and permits the user thread to run until either the thread gives 
up control or timer 28 times out (Step 123). After the thread has completed 
25 execution, the time used by the current thread is determined in Step 124. In 
Step 126 the time left value for the current thread is then updated by 
subtracting the time used by the current thread (as determined in Step 124) 
from the time left value for the current thread. 

30 Preferably, if the thread stops running by giving up control 

before timer 28 times out then at step 126 the time left value for the thread 
is reduced to zero. As a result, the next time the thread comes to the 
attention of scheduler 32 it will be moved to the rear of queue 42, as 
described below, instead of being re-scheduled immediately. A thread may 

35 give up control over processor 22 voluntarily when it has finished its current 
batch of work. A thread may also voluntarily give up control over processor 
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22 when it is blocked. A thread is blocked when it has further work to do but 
requires access to some system resource to perform the work. For example, 
a thread might be blocked when it performs a read from a file and there is no 
data available, or it performs a monitor entry operation but the monitor is 
5 already occupied by another thread. 

When a thread is blocked it is no longer "ready to run" and is 
therefore no longer eligible to participate in the competition among the 
threads in queue 42 to become the next current thread. Where a thread gives 

10 up control of processor 22 because it is finished all of the work that it has to 
do then it is generally preferable to set the time left value for the thread to 
zero. If the time left value for the thread is left at a value greater than zero 
then the thread will still have the earliest time stamp of all user threads, and 
will be re-scheduled immediately. Resetting the "left" value for a thread 

15 which gives up control of processor 22 to zero will ensure that the thread is 
moved to the rear of queue 42 after all other active user threads in the 
service list 40. Method 100 then returns to Step 110 to select a new current 
thread. 

20 If, in Step 118, it is determined that the time left value for the 

current thread is less than or equal to zero then a new timestamp is 
generated for the current thread in Step 128. Note that Step 128 is never 
practised on system threads and therefore the timestamp for system threads 
remains fixed. In Step 130 the time left value for the current thread is 

25 initialized. Initializing the time left value for the current thread typically 
involves multiplying the service fraction for the current thread by a virtual 
time quantum T. The virtual time quantum JTis a user-defined system 
constant, T\s> notionally the time which would be taken for all threads in 
service list 40 to be executed just once in a case where the service fractions 

30 for all of the active threads totals 100%. 

As illustrated in Figure 5, as each user thread runs on processor 
22, its time left value is reduced. When the time left value for the thread has 
been reduced to zero then the thread is assigned a new timestamp which is 
35 later than time stamps of all other user threads in the service list 40. The 
result is that threads in the user portion 46 of service list 40 leap frog one 
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another as time passes. In Figure 5, a thread 60 has just completed running. 
Thread 60 is assigned a new timestamp which is later than the timestamps 
of any of the four other active user threads in service list 40. Thus, thread 60 
is moved to the rear of the list of active service threads, as indicated hy arrow 
5 62. 

Those threads which have a larger service fraction will have a 
larger time quantum each time their time left values are initialized in step 
130. Consequently, threads having a large service fraction are ahead of other 
10 user threads in queue 42 will have more time running on processor 22 before 
being moved behind other user threads in queue 22 than will user threads 
having a smaller service fraction. 

In the preferred embodiment of the invention, timestamps are 
1 5 not re-used. As each thread uses up the quantum of processor time which was 
specified when its time left value was initialized the thread is assigned a new 
timestamp which is later than that of any other active user threads. The 
integer used to represent the timestamp has a large enough range of values 
that the supply of new timestamps for user threads is practically 
20 inexhaustible. For example, the timestamp may be a 64-bit integer value. In 
this case, if one hundred values of the timestamp were used up every 
microsecond then it would still take over 5,000 years to use up every possible 
timestamp value. 

25 Low priority system threads, which have timestamps in low 

priority system area 48 will run only when there are no runnable high 
priority system threads and no runnable user threads since the timestamp 
values for low priority system threads are later than the timestamp values 
for any other threads. Low priority system threads might include, for 

30 example, an idler thread, a garbage collection thread, and a finalizer thread 
which invokes the finalizeO function of discarded JAVA objects. The idler 
thread need not do any useful work. The idler thread is always ready to run. 
Its presence ensures that there is always at least one runnable thread to be 
scheduled. 

35 
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Most preferably the garbage collection thread and the finalizer 
thread are treated as user threads and are each assigned a small service 
fraction. If these threads are assigned timestamps in low priority system 
area 48 which gives them very low priorities then they may not run 
5 frequently enough if the system is busy running higher priority threads. 
This can eventually cause a Java virtual machine to run low on memory. If 
this happens then the Java virtual machine must pause to run the garbage 
collector thread. If the garbage collector is run as a user thread in a system 
according to the invention, on the other hand, then the garbage collector can 
10 be guaranteed a small share of CPU time without significantly affecting the 
operation of user threads. 

Timestamps in reserved area 50 may be assigned temporarily 
to user threads for implementing necessary system maintenance tasks which 
1 5 should not be interrupted by user threads. For example, user threads may be 
temporarily assigned timestamps in reserved area 50 if a low memory 
situation develops so that it is necessary to run a garbage collection routine. 
After memory has been freed by running the garbage collection routine then 
the previous timestamps of the user threads may be restored. 

20 

Figure 6 is a block diagram which shows functional units in a 
computer system according to one embodiment of the invention. System 200 
includes a global priority mapper 210, a scheduler 212, a resource 
consumption tracker 214, a timer handler 216, and a time sheer 218 each of 
25 which may comprise a software thread capable of running on a computer 
processor. Global priority mapper 210 assigns timestamps to user threads 
and initializes the time left values for each thread according to the service 
fraction (CPU resource allocation) for the thread. 

30 Scheduler 212 is invoked each time it is necessary to select a 

new thread to run. The times when scheduler 212 is invoked to select a new 
current thread may be called decision epochs. A decision epoch occurs, for 
example, whenever the current thread is blocked or pre-empted. A decision 
epoch may occur, for example, when a current thread is pre-empted by a 

35 signal handler, when the thread performs some system activity, such as I/O, 
monitor operations or thread creation, or when it yields control of the 
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processor- In a Java environment, scheduler 212 may rely on asynchronous 
signals from an operating system for notification of events such as timer time 
out or changes in device status. The handler for such a signal will invoke 
scheduler 212 to cause the currently running thread to he pre-empted and a 
5 new thread (which could be the same thread as the currently running 
thread) to be scheduled. At each decision epoch, scheduler 212 selects a 
thread for execution. Scheduler 212 scans list 40 (or queue 42) to locate the 
runnable thread with the highest global priority (earliest timestamp). If the 
thread identified is not a system thread and has used up its allotment for the 

10 current quantum (i.e. has a time left value <;0) then scheduler 212 calls 
global priority mapper 210 to re-initialize the quantum and global priority 
(timestamp) for the thread. Global priority mapper 310 resets the priority 
for each thread to be a x f + L where a is the service fraction of the thread, 
7*is the virtual time quantum and Lis the last time left value for the thread. 

15 Scheduler 212 then resumes scanning list 40 (or queue 42) to locate another 
runnable thread with the highest global priority. Scheduler 2 12 repeats this 
operation until it finds a thread with a positive time left value which is ready 
to run. 

20 If the thread identified is a system thread or is a user thread 

which has not used up all of its allotment for the current quantum then 
scheduler 212 transfers the control of the CPU to the current thread and sets 
timer for the time slicer to expire at the end of the next preemption interval, 
or when the current thread's current quantum is exhausted, which ever 

25 comes first. 

Resource consumption tracker 214 takes clock readings before 
the control of the CPU is transferred to a thread and takes clock readings 
again after the control is given up or revoked. Resource consumption tracker 
30 214 then calculates the CPU resource consumption of the thread during the 
last execution and, if the thread is not a system thread subtracts this amount 
from the thread's time left value. Resource consumption tracker may be 
implemented as part of the context switching code which runs whenever 
context is switched from one thread to another thread. 

35 
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Timer handler 216 services hardware clock interrupts and 
supports timer time-outs. Timer slicer 218 registers timer timeouts with 
timer handler 216. When the timer times out then time slicer 218 is invoked 
(or "woken up") and causes re-scheduling of threads. This prevents any 
thread from monopolizing the use of the CPU resource. Time slicer 218 
interrupts the currently running thread after a time AT which is equal to the 
smaller of the time left value for the thread and a preemption interval. 
Every time scheduler 212 selects a new thread to run it sets a time-out for 
time slicer 218 that will expire after AT time units. When the time-out 
expires, time sheer 218 becomes runnable. Because time sheer 218 always 
has an artificially early timestamp value, the time slicer thread pre-empts 
the current user thread and causes a re-scheduling. If the current user 
thread is blocked for some reason, such as a monitor operation, before the 
time AT passes then scheduler 212 cancels the time-out and sets out a new 
time-out when the next thread is scheduled. 

When a new user thread is created the new user thread is 
preferably assigned a timestamp which is later than that of any other user 
thread in service list 40. Consequently, even though creating the new thread 
will lead to a decision epoch, it alone will not cause the current thread to be 
pre-empted. 

In this invention Hoare's "monitor" mechanism (as described in 
C.A.R. Hoare, Monitors: An Operating System Structuring Concept, 
Communications of the ACM, 17(10):549-557, October, 1974) maybe usedfor 
thread synchronization. When this is done, signal handling is asynchronous 
and is split into two parts: a very simple signal handling function is invoked 
when a signal arrives. Ths signal handling function invokes a more elaborate 
signal handling thread. The primary role of the signal handling function is 
to notify the signal handling thread when a signal is delivered. When a 
signal is delivered, the current thread is suspended and the signal handling 
function for the signal is invoked. The signal handling function first invokes 
context switching code, as described above, to preserve the state of the 
current thread. The signal handling function then makes its corresponding 
signal handling thread ready to run. This may be accomplished, for example, 
by providing a monitor for each signal handling thread and keeping each 
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signal handling thread in a condition wait queue for its monitor until the 
signal handling function makes the signal handling thread runnable by 
setting the condition of the condition wait queue in which the signal handling 
thread is waiting to true. This removes the signal handling thread from the 
5 condition wait queue for its monitor. The signal handling thread becomes 
runnable immediately. Since the signal handling thread is typically a high 
priority system thread it will run immediately (unless pre-empted by a 
higher priority system thread). When the signal handling thread finishes, or 
is pre-empted, the context switch code is invoked and the scheduler function 
10 is called to schedule a new thread. Signal handler functions may use the 
stack of a pre-empted thread. 

As an example, a signal handling function may be associated 
with a timer 28. The signal handling function is invoked whenever timer 28 
15 times out. The signal handling function can cause a clock handler thread to 
become runnable, and to perform actions which follow from the time-out. 

Preemption bv Operating System 

One problem can occur when it is desired to implement this 

20 invention in a multitasking operating system. If a JAVA virtual machine 
which implements thread scheduling according to the invention is running 
in such an operating system then the operating system may periodically 
preempt the JVM and give the processor to another program. If this happens 
then the computation of the time used by a thread can become inaccurate. 

25 Consider, for example, the situation that would occur if a JVM schedules a 
thread Tat time t and the thread runs until a time t + At s at which point the 
operating system takes away control from the JVM (and thread 7) until a 
time t+Ati+At^. Thread Tis then allowed to run until time t+At 2 +At 2 
+At 3 . The resource consumption tracker 214 would think that thread jThad 

30 run for a time At 2 + At 3 + At 3 whereas, in reality thread Fhas only run for 
At j +At 3 time units. 

A solution to this problem is to use the real-time scheduling 
facility, which is provided by most modern multi-tasking operating systems, 
35 to prevent the operating system from arbitrarily preempting the JVM. The 
JVM may be given a higher priority than any other program running under 
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the multitasking operating system, including some functions of the operating 
system itself. To ensure that the operating system has access to the processor 
for necessary tasks, the JVM can run a thread (em "OS thread*) which has a 
service fraction but does nothing but yield control of the processor to the 
5 operating system. For example, 10% of the available processor bandwidth 
might be allocated to the OS thread* 

Timestamn Inversion 

Another problem that can occur through the use of the invention 

10 is timestamp inversion. Timestamp inversion can occur when monitors are 
used for synchronization between threads, as is done in Java applications. 
A monitor is a resource which is available to only one thread at a time. If the 
monitor is free then a thread can enter the monitor. Otherwise a thread 
wishing to enter the monitor must wait until the monitor is free . Timestamp 

15 inversion can occur when a lower priority thread which is executing inside 
a monitor blocks a higher priority thread which wishes to enter the same 
monitor. Consider, for example, the case where T 2 and T 2 are two threads, 
T 2 is a runnable thread, and T } has a timestamp earlier that that of any 
other runnable thread- T 2 is running inside a monitor M T 2 has a later 

20 timestamp than T 2 and is waiting to enter M. When T 2 finishes its quantum 
i.e. when its "time left" value becomes zero, scheduler 212 will move thread 
Tj to the rear of queue 42 by assigning it a new timestamp. Since T 2 no 
longer has a timestamp earlier than T# it should no longer block T 2 
However, T 2 will not give up its resources and in particular it will not give up 

25 the monitor M it is currently holding. As a result, T 2 cannot proceed, even 
though it may have an earliest timestamp which is earlier than the 
timestamp of T 2 which occupies the monitor M, and is blocking T 2 at the 
entrance of monitor M. 

30 The problem of timestamp inversion may be addressed as 

follows. When a thread attempts to enter an occupied monitor, the thread is 
blocked. Each time this occurs, the scheduler compares the timestamp for 
the thread to the timestamp of the thread which "owns" the monitor. If the 
thread which is waiting to enter the monitor has an earlier effective 

35 timestamp, then the thread which is in the monitor temporarily inherits the 
earlier timestamp as a new effective timestamp. When the thread in the 
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monitor exits the monitor, the scheduler restores its former time stamp. 
Moreover, when a thread which is inside a monitor finishes its quantum (ie. 
when its time left value becomes zero) that thread is assigned a new 
timestamp and its time left value is re-initialized. However, if the monitor's 
5 wait queue is not empty (i.e. there are other threads waiting to enter the 
monitor) then the thread in the monitor would temporarily be given its 
original timestamp as its effective timestamp until it exits the monitor. 
When the thread exits the monitor the new timestamp comes into effect As 
a result, the thread in the monitor may finish its critical section as quickly 

10 as possible and release the monitor for use by other threads. The thread will 
resume its rightful place in the service list after it leaves the monitor. While 
this scheme for addressing timestamp inversion problems is simple and 
allows fair scheduling even when synchronization is required, it may have an 
adverse effect on some quality of service guarantees, such as any fairness 

15 guarantees because the blocking thread is allowed to "borrow" time from its 
next quantum. 

Systems which implement modified move to rear list scheduling 
according to the invention can provide a cumulative service guarantee. The 

20 delay that a particular process experiences will not accumulate over the 
lifetime of the process and the service rate perceived by the process will not 
be less than the admitted service rate, as specified by the service fraction, by 
more than a constant amount. Thus, such systems are well adapted for use 
by soft read-time applications, such as the delivery of multimedia 

25 information. 

The invention may be embodied in a program product. The 
program product comprising any medium which carries a set of computer- 
readable signals corresponding to instructions which, when run on a 
30 computer, cause the computer to execute a method of the invention. The 
program product may be distributed in any of a wide variety of forms. The 
program product may comprise, for example, physical media such as floppy 
diskettes, CD ROMs, DVDs, hard disk drives, flash RAM or the like or 
transmission- type media such as digital or analog communication links. 

35 
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As will be apparent to those skilled in tlxe art in light of the 
foregoing disclosure, many alterations and modifications are possible in the 
practice of this invention without departing from the spirit or scope thereof. 
Accordingly, the scope of the invention is to be construed in accordance with 
5 the substance defined by the following claims. 
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WHAT IS CLAIMED IS: 

1. A computer implemented method for scheduling the running of 
threads, the method comprising: 

a) maintaining a list of a plurality of threads, the plurality of 
5 threads comprising at least one high priority system thread and 

at least one user thread and, for each of the plurality of threads, 
maintaining a timestamp value, a service fraction value and a 
time left value; 

b) identifying as a current thread one of the plurality of threads 
10 which is ready to run and has a timestamp value earlier than 

the timestamp value of any other of the plurality of threads 
which is ready to run; 

c) if the time left value for the current thread is greater than zero, 

i) transferring control to the current thread for a running 
15 time not exceeding the time left value for the current 

thread; and, 

ii) if the current thread is not a system thread, subtracting 
the running time from the time left value for the current 
thread; and, 

20 d) if the time left value for the current thread is not greater than 

zero, assigning a new timestamp value to the current thread, 
the new timestamp value being later than the timestamp 
values of any of the user threads, and initializing the time left 
value of the current thread. 

25 

2. The method of claim 1 wherein the plurality of threads comprises at 
least one low priority system thread, the low priority system thread 
having a timestamp value later than a timestamp value of any of the 
user threads. 



30 



The method of claim 1 wherein initializing the time left value of the 
current thread comprises setting the time left value as the service 
fraction value of the current thread multiplied by a virtual time 
quantum. 
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4. The method of claim 3 wherein the virtual time quantum is a time 
within which each of the plurality of threads would be executed once 
if the plurality of threads had service fractions totalling one hundred 
per-cent. 

5 

5. The method of claim 1 wherein the threads are threads in a JAVA 
programming environment. 

6. The method of claim 5 wherein the high priority system threads 
10 comprise a dock handler thread, the clock handler thread servicing a 

clock interrupt. 

7. The method of claim 6 wherein the high priority system threads 
comprise a time sheer thread, the time slicer thread having a later 

15 timestamp than the clock handler thread. 

8. The method of claim 5 comprising providing an Operating System 
which provides priority-based real-time scheduling; running a Java 
Virtual Machine on the Operating System at a priority higher than a 

20 priority allocated to the Operating System; and providing an OS 

thread running on the Java Virtual Machine, the OS thread providing 
CPU resources to the Operating System. 

9. The method of claim 5 wherein the user threads comprise a garbage 
25 collection thread and a finalizer thread wherein the garbage collection 

thread runs a garbage collection routine and the finalizer thread runs 
finalizeO routines of discarded JAVA objects. 



10. The method of claim 5 wherein one of the user threads comprises an 
30 OS thread, the OS thread providing CPU resources to an underlying 

operating system. 

11. The method of claim 1 comprising maintaining a queue containing 
records of all ready-to-run threads in the list, the records arranged in 

35 the queue in order of the timestamp values for the corresponding 

threads. 
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12. The method of claim 1 wherein the timestamp comprises an integer 
having in excess of 45 bits. 

13. The method of claim 7 wherein the time slicer thread uses a timer to 
5 discontinue execution of a thread after the lesser of a predetermined 

preemption time and the time left value for the thread. 

14. The method of claim 5, comprising running the threads on a computer 
comprising a processor capable of directly executing Java byte codes. 

10 

15. The method of claim 5, comprising running the threads on a computer 
comprising a processor running an operating system, a computer 
program emulating a Java processor and a Java operating system, 

15 16. The method of claim 5 wherein the low priority system threads 
comprise an idler thread, wherein the idler thread is always ready to 
run. 

17. Computer system comprising a processor, a memory accessible to the 
20 processor, an operating system and a computer program emulating a 

Java processor running on the processor, the computer program 
providing a scheduler for scheduling the running of Java threads on 
the processor, the scheduler maintaining a list of a plurality of 
threads, the plurality of threads comprising at least one high priority 
25 system thread and at least one user thread and, for each of the 

plurality of threads, maintaining a timestamp value, a service fraction 
value and a time left value; the scheduler adapted to: 
a) identify as a current thread one of the plurality of threads 
which is ready to nm and has a timestamp value earlier than 
30 the timestamp value of any other of the plurality of threads 

which is ready to run; 
c) if the time left value for the current thread is greater than zero, 
i) transfer control to the current thread for a running time 
not exceeding the time left value for the current thread; 
35 and, 
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ii) if the current thread is not a system thread, subtract the 
running time from the time left value for the current 
thread; and, 

d) if the time left value for the current thread is not greater than 
5 zero, assign a new time stamp value to the current thread, the 

new timestamp value being later than the timestamp values of 
any of the user threads, and initializing the time left value of 
the current thread. 



10 18. A computer readable medium having computer readable program logic 
recorded thereon, the program logic, when run on a computer, 
implementing a method comprising: 

a) maintaining a list of a plurality of threads, the plurality of 
threads comprising at least one high priority system thread and 

15 at least one user thread and, for each of the plurality of threads, 

maintaining a timestamp value, a service fraction value and a 
time left value; 

b) identifying as a current thread one of the plurality of threads 
which is ready to run and has a timestamp value earlier than 

20 the timestamp value of any other of the plurality of threads 

which is ready to run; 

c) if the time left value for the current thread is greater than zero, 

i) transferring control to the current thread for a running 
time not exceeding the time left value for the current 

25 thread; and, 

ii) if the current thread is not a system thread, subtracting 
the running time from the time left value for the current 
thread; and, 

d) if the time left value for the current thread is not greater than 
30 zero, assigning a new timestamp value to the current thread, 

the new timestamp value being later than the timestamp 
values of any of the user threads, and initializing the time left 
value of the current thread. 



35 19. 



A computer system comprising: 
a) a processor; 
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b) a multi-threaded operating system running on the processor, 
the operating system comprising a plurality of system threads; 

c) user software running on the computer system, the user 
software comprising one or more user threads; 

5 d) a memory accessible to the processor, the memory containing a 

data structure comprising a record for each of a plurality of 
threads, the plurality of threads comprising at least one high 
priority system thread and the one or more user threads, each 
record comprising a timestamp value, a service fraction value 

10 and a time left value for a thread corresponding to the record; 

e) a scheduler, the scheduler adapted to identify as a current 
thread one of the plurality of threads which is ready to run and 
has a timestamp value earlier than the timestamp value of any 
other of the plurality of threads which is ready to run and, if the 

15 time left value for the current thread is greater than zero, 

i) transfer control of the processor to the current thread for 
a running time not exceeding the time left value for the 
current thread; and, 

ii) if the current thread is not a system thread, subtracting 
20 the running time from the time left value for the current 

thread; or, 

if the time left value for the current thread is not greater than 
zero, assigning a new timestamp value to the current thread, 
the new timestamp value being later than the timestamp 
25 values of any of the user threads, and initializing the time left 

value of the current thread. 
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pans, where each pan may depend on the other. As a 
consequence of these inlcr-dependencies, the selection of 
one part might exclude other pans from being included 
in the Finished product. A consistent configuration is a 
selection of parts where all inter-dependencies arc satisfied. 
A computer program for computer-assisted configuration 
helps an end-user to make choices that will lead to a 
consistent product. The preferred embodiment of the present 
invention, Virtual Tabulation, is a method for keeping track 
of inlcr-depcndcs a large number of parts, to allow for the 
construction of an efficient and exact configuration program. 
Such a program allows interactive configuration over 
networks (e.g., the Tntemel). Another aspect of the invention, 
called Smart Search, allows a set of inter -de pendencies 
among parts to be computed from a product database. 
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(57) Abstract: A framework enables data source 
components to be developed independently of data 
consumer components. A mediation layer, typically 
implemented as a group of APIs (application 
programming interface), handles and defines the 
mediation and interface between the source and 
data components. The framework, called XIS 
(extensible information system), is especially suited 
for development of in formation -handling systems 
and applications. Data source components and data 
consumer components are typically designed to 
communicate with each other via several interfaces. 
Domain, relationship, attribute/metadata, and change 
event interfaces are defined within the mediation 
layer. Other interfaces may also he defined. Data 
source components that are written for non-XIS 
aware environments or frameworks may still be used 
with XIS by "wrapping" snch source components 
with code to conform to the interface requirements. 
Java objects are examples of data source components. 
Data consumer components thus are able to use or 
consume various source components regardless of 
the data types and the data source. Thus, once a data 
consumer component is developed within the XTS 
framework, any data source components within the 
XIS framework may be consumed by a data consumer 
component. 
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EXTENSIBLE INFORMATION SYSTEM 

A portion of the disclosure of this patent document contains material, which is 
subject to copyright protection. The copyright owner has no objection to the facsimile 
reproduction by anyone of the patent document or the patent disclosure, as it appears 
in the Patent and Trademark Office patent file or records, but otherwise reserves all 
copyright rights whatsoever. 

This application claims priority of co-pending U.S. Provisional Patent 
Application Serial No. 60/242,041 entitled "Extensible Information System (XIS)" by 
R. Kadel et al. f filed October 20, 2000. Priority of the filing date of October 20, 2000 
is hereby claimed, and the disclosure of said Provisional Patent Application is hereby 
incorporated by reference. 

BACKGROUND 

1. Field Of The Invention 

The present invention relates generally to data processing systems and, more 
particularly, to systems that process, analyze, and display data or information. 

2. Description of the Related Art 

The continuing inroads made by computer technology into the practices of 
information storage and manipulation have opened up new realms of possibility for 
intelligent, informed derision-making. From labor statistics and scientific databases 
like the human genome project to traffic patterns and aircraft positions, the 
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availability of information in electronic form allows sophisticated analysis techniques 
and display methods to be applied at the touch of a button. However this diverse 
array of information also poses significant challenges in areas such as: 

effective organization of information; 
5 - ability to interpret and manipulate information in an increasingly 

wide variety of formats so that data and processing software can 

be brought together in a compatible but also timely and effective 

way; and 

recognizing and navigating relationships between disparate 

10 information types. 

This task of information management has already grown beyond the ability of 
human operators to keep pace with it, and in most applications, there is far more 
relevant information electronically available on the web and elsewhere than is 
effectively used. The problem is that software affording display of and interaction 

15 with information must be custom-designed for the particular type and format of the 
information it will work with. This leads to high costs of software development and 
limited availability of software appropriate to information of interest, and poor 
integration between information from different sources. An analyst must use one 
program when dealing with geographic distribution data such as precipitation amounts 

20 or land use, another for rendering 3 -dimensional terrain, another for examining 

congressional districts and voting records, and so on. Many desirable applications of 
available data, such as determining correlations between political party and land use 
strategy in this case, fall between the cracks left by specialized applications, and there 
is no easy way to allow them to interoperate. 

25 The primary means for allowing one application to operate on the results of 

another are the limited cut and paste facilities offered by many operating systems, 
which allow plain or formatted text oi images to be moved between programs. There 
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is no independent way to transfer structured data such as a table of numbers with 
particular column headings, a set of lists of items under specified categories, or even • 
something as simple as a single number with an associated unit of measurement 
From the discussion above, it should be apparent that there is a need for 
5 computer systems that have greater ability to develop, integrate, and interoperate with 
disparate sources of information, to more easily develop software applications, 
components, or objects, and to facilitate interoperation of data between software 
components. The present invention fulfills this need. 



]0 SUMMARY OF THE INVENTION 

In accordance with the present invention, a framework for use with object 
oriented programming (OOP) systems provides a framework user with classes that 
comprise a mediation layer that defines an interlace between data source components 

15 and data consumer components such that the configuration of the data source 

components can be specified independently of the data consumer components. The 
mediation layer specifies data relationships of the data objects, domain methods for 
defining groups of class attributes, attribute metadata for defining groups of class 
attributes, and change event registration for detecting changes in data values. Thus, 

20 when extended, the mediation layer of the framework can support runtime data 
manipulation between unrelated data source components and data consumer 
components. In this way, the framework provides an extensible information system. 
The framework will be referred to herein as "XIS", and is especially suited to assist in 
the development of information-handling systems or applications. 

25 Data source components that are configured for a non-XIS-aware 

programming environment or framework may still be used with XIS by "wrapping" 
such source components with code to conform to the interface requirements. Data 
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objects of the well-known 11 Java" programming language are examples of data source 
components. Data consumer components thus are able to use or consume various data 
source components regardless of the data types and the data source. Thus, once a data 
consumer component is developed within the XIS framework, any data source 

5 components within the XIS framework may also accordingly be used. The 

framework can be provided as a group of APIs (application programming interface). 

The XIS framework of the present invention also includes libraries and APIs 
that provide information management technologies that enable developers and 
integrators to combine XlS-aware components, data sources, and off-the-shelf 

10 JavaBeans into complete systems designed around whatever architecture is best for 
the situation. XIS further supports multiple, dynamic domains and is scalable to n-tier 
systems using the latest technology. The framework enables many developers to 
choose architectures based on their requirements (e.g., server, client/server, 
application server, web server, standalone, hand-held, etc.). 

15 Other features and advantages of the present invention should be apparent from 

the following description, which illustrates, by way of example, the principles of the 
invention. 

BRIEF DESCRIPTIONS OF THE FIGURES 

20 

Figure 1 is a diagram of the extensible information system (XIS) framework 
constructed in accordance with the present invention. 

Figure 2 is a more detailed diagram of Figure 1, showing the various interfaces 
within XIS, constructed in accordance with the present invention. 
25 Figure 3A is a mqre detailed diagram of Figure 1, including information and 

services available within XIS, constructed in accordance with the present invention. 
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Figure 3B is a hierarchical structure diagram of an embodiment of an 
InfoModel constructed in accordance with the present invention. 

Figure 4 is a more detailed diagram of Figure 1 showing various information 
available to components within XIS constructed in accordance with the present 
5 invention. 

Figure 5 is a diagram of the semantic representation of a data item within the 
XIS framework constructed in accordance with the present invention. 

Figures 6 A to 6F show data consumer components, particularly display 
components, constructed in accordance with the present invention. 
10 Figure 7 shows a consumer component displaying the properties exposed by a 

data source object constructed in accordance with the present invention. 

Figure 8 is a unified modeling language (UML) diagram of a Person object. 

Figure 9 lists a set of attributes exposed within the XIS framework by the 
Person object of Figure 6 constructed in accordance with the present invention. 
15 Figure 10 illustrates that an object constructed in accordance with the present 

invention may subscribe to more than one domain policy or definition. 

Figure 1 1 shows a domain usage and sequence scenario between a consumer 
component and source component constructed in accordance with the present 
invention. 

20 Figures 12 A to 12D list information regarding a Type Metadata package class 

typically implemented in the mediation layer and constructed in accordance with the 
present invention. 

Figure 1 3 shows a relationship usage scenario diagram between a consumer 
component and source component constructed in accordance with the present 
25 invention. 

Figure 14 is a flow chart that shows a reference resolution scenario usage 
sequence in which an indirect reference to an information element is created, passed 
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around, and then resolved by two separate data consumers, causing reconstruction to 
occur only the first time. 

Figure 15 lists an exemplary Java source file to implement an information- 
handling application constructed in accordance with the present invention. 
5 Figures 16A to 1 6B list an exemplary Java source file to implement an 

information-handling application constructed in accordance with the present 
invention. 

Figure 17 shows a data consumer component using a source component 
constructed in accordance with the present invention. 
10 Figures 18A to 18B list an exemplary Java source file to implement an 

information-handling application constructed in accordance with the present 
invention. 

Figures 19 A to 19B list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
15 invention. 

Figure 20 shows a data consumer component using a source component 
constructed in accordance with the present invention. 

Figure 21 lists an exemplary Java source file to implement an information- 
handling application constructed in accordance with the present invention. 
20 Figures 22A to 22C list ah exemplary Java source file to implement an 

information-handling application constructed in accordance with the present 
invention. 

Figures 23A to 23D list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
25 invention. 

Figures 24A and 24B show two data consumer components using a source 
component constructed in accordance with the present invention. 
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Figures 25A to 25C list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present 
* invention. 

Figure 26 shows a data consumer component using a source component 
5 constructed in accordance with the present invention. 

Figure 27A and Figure 27B show a flow chart of a data exposure facility 
within the XIS framework constructed in accordance with the present invention. 

Figure 28 is a diagram of how InfoModcls constructed in accordance with the 
present invention provide contextualization with the XIS framework. 
io Figure 29 is a diagram of the pluggable service facilities within XIS 

constructed in accordance with the present invention. 

Figure 30 shows a flow diagram of a wizard or an API constructed in 
accordance with the present invention that assists in creating XML (extensible 
markup language) DSIs and database DSIs. 
15 Figure 3 1 shows objects and methods involved in distribution collaboration 

facilities constructed in accordance with the present invention. 

Figure 32 shows semantic repositories for distributed agents constructed in 
accordance with the present invention. 

Figures 33 A to 33P list information regarding a ContentlnfoBean class 
20 constructed in accordance with the present invention. 

Figures 34A to 34D list an information management package typically 
implemented in the mediation layer and constructed in accordance with the present 
invention. 

Figures 35 A to 35F list an InfoModel interface package typically implemented 
25 in the mediation layer and constructed in accordance with the present invention. 
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Figures 36A to 3 6B list a package for handling change events typically 
implemented in the mediation layer and constructed in accordance with the present 
invention. 

Figures 36C and 36D show two sequence diagrams showing how change 
5 • events are handled and constructed in accordance with the present invention. 

Figures 37A to 37D list an exemplary Java source file to implement an 
information-handling application constructed in accordance with the present ■ 
invention. 

Figures 38A, 38B, 38C, and 38D show two data consumer components using a 
10 source component constructed in accordance with the present invention. 

Figures 39A, 39B a and 39C is list information concerning an AttributcAlias 
class of the framework. 

Figure 40 is a block diagram of a computer device that may be used to operate 
with the framework, in accordance with the present invention. 

15 

DETAILED DESCRIPTION 



The following detailed description illustrates the invention by way of example, 
not by way of limitation of the principles of the invention. This description will 

20 clearly enable one skilled in the art to make and use the invention, and describes 
several embodiments, adaptations, variations, alternatives and uses of the invention, 
including what we presently believe is the best mode of carrying out the invention. 

The invention will be described by way of illustration with reference to various 
classes, objects, sample codes, etc. written within the exemplary framework, but it 

25 should be understood that such classes, class libraries, application programming 

interfaces, interfaces, objects, etc. may be differently coded, implemented, designed, 
etc. and yet support the functions and features of the present invention. 
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Object-Oriented Technology 

Many application programs and APIs (application program interface) are 
developed using object-oriented (OO) technology. Using 00 technology, a system is 
typically developed as a collection of interrelated cooperative objects that are 
5 instances of classes that typically include corresponding states and behaviors. A class 
is a blueprint or template that defines the variables and the methods common to all 
objects that are instances of the class. An object maintains its state in one or more 
variables and implements its behavior with methods or functions. 

Object-oriented programming (OOP) techniques encapsulate, or bind together, 

id data and the methods that operate on them. This encapsulation permits program 
development to more closely model real-world entities and breaks up program 
development efforts into smaller, more manageable pieces. Although OOP 
techniques have done much to improve program development efficiency, such 
techniques still require a great degree of code generation on the part of developers, 

15 which discourages program reuse. 

Even with OOP techniques, specifying data sources and the way in which data 
will be retrieved or updated from the data sources are still typically hard-coded within 
the objects themselves. An object, for example, may be specified to display pricing 
data (for example, a price display object) and would likely be hard-coded such that 

20 the data source is predefined. Thus, an object may be written to retrieve data from a 
source such as a relational database management system (RDBMS), a spreadsheet file 
such as a spreadsheet in the format of "EXCEL" spreadsheet application by Microsoft 
Corporation, or the object may be written to an XML file. Nevertheless, in 
conventional systems, the price display object would be limited such that if a different 

25 source of data, for example, an XML file rather than an EXCEL file, has to be used, 
the object has to be modified to incorporate access to and manipulation of the XML 
file. Furthermore, if a different set of fields are retrieved, for example, latitude and 
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longitude (i*e., data fields unrelated to pricing information), a new object to display 
latitude and longitude may have to be written to display such information in tabular 
format. 

Table I below shows the data configuration of a typical object 



Table I 

State/Properties: Name, SSN, position, DOB, and . . 
Behavior: RecordQ 

getRecords(DateRangc) 

promote 0 



For an application to be able to use this data object, the application would need 
prior knowledge of object properties (state) and behavior. The application would be 
tightly coupled with the class from which the object was instantiated. The meaning 
and intent of the data might be found in the source code or by asking the original 
programmers (e.g., SSN is social security number stored as string rather than a 
numeric type). 

Assuming the object was created by one application written independently of 
another, the object could not be intelligently exchanged between the first application 
and the other with the expectation that the object would be processed unless the 
applications were tightly coupled. A way to have objects be used in various 
applications is thus highly desirable to reduce programming time and resources. 

Common OOP languages include "Java" from Sun Microsystems, Inc. of Palo 
Alto, California, USA, C++, Simula, and Smalltalk. 
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Framework 

The concept of a framework is an important part of 00 programming 
technique. A framework is a specification of the classes and the relationships 
between classes such that the framework defines a class hierarchy that can be used 

5 over and over again, with overrides and extensions. In this way, an initial problem 
solution specified by a class hierarchy can be adapted and customized for new 
circumstances, simplifying program maintenance. In essence, a framework is a set of 
OOP classes that embodies a predetermined set of attributes and methods for 
providing a common group of behaviors* 

10 OOP frameworks have been developed in an effort to further reduce program 

development costs. An application program developer utilizes the framework and 
builds upon it, starting with the classes, attributes, and methods defined by the 
framework designer and adding subclasses and attributes and modifying methods 
depending on the problem to be solved Such changes to the framewoik are typically 

15 referred to as framework extensions, and are made possible by the OOP notions of 
inheritance and polymorphism. Thus, a framework can speed the development of an 
OO application program. The challenge confronting framework developers, then, is 
to define a set of classes and methods that best supports the desired problem solution 
and will accept the most Jikely framework extensions. Thus, the designer of a 

20 framework must carefully assess what framework users will most likely need in the 
way of classes, attributes, and methods. 

It is therefore a technical advantage of the present invention to provide a 
framework that allows information-handling software to adapt to new data types and 
formats of information, so that a single application built within this framework has a 

25 significantly broader range of compatibilities and domains of usefulness than a 

conventional application and, further, may automatically interoperate at a structured 
level with other similarly enhanced applications. In one embodiment of the present 
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invention, desirable applications of data such as determining correlations between 
political party and land use strategy may be facilitated. 

In an embodiment of the present invention, a single information visualization 
or manipulation application is able to handle many diverse types of information, even 
5 those that are conceived and developed subsequently to the completion of 
development of the application itself. 

In another embodiment of the present invention, information from multiple and • 
diverse sources yet sharing some basic feature in common - such as being distributed 
in geographic space, or being distances measured in meters - can be simultaneously 
10 displayed (superimposed) and manipulated within a single application. This invention . 
further provides means of access to common data sources such as relational databases, 
extensible markup language (XML) streams, and "Java" programming language 
software objects. 

In an embodiment of the present invention, an information-handling 
15 application is defined as any software application which is capable of utilizing 

digitally available structured information in bulk form, such as fiom electronic files, 
databases, or internet web sites to provide a display and/or a set of possible 
manipulations to a user, such as after some internal processing and transformation of 
the information such as summarizing it, performing computations on it, or selecting a 
20 subset Examples include but are not limited to graphing programs, analysis tools (for 
handling financial data, statistical, time series, etc.), and interfaces to geographic 
information systems. Prototypical information-handling applications process 
structured information that has some form of hierarchical and/or modular structure. 
In one embodiment, image and word processing applications are not examples of 
25 what we term information-handling applications. In another embodiment of the 
present invention, structured information in bulk form does not include plain text or 
specific electronic media files such as MP3 files. 
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A conventional information handling application such as a graphing program 
comprises two major components: one component handles the intake of information, 
from storage devices, the network, or user input, and the other component handles the 
display of the information. There may also be parts of the application that perform 

5 computations or transformations on the information before it is displayed. From the 
developer's perspective, a modular piece of software that handles a portion of (or all 
of) the data intake function is a data source component, because it provides 
■ information to other components within the application. A modular piece of software 
that handles part of (or all of) either the computation, transformation, or display of 

10 information is a data consumer component, because it uses (consumes) information 
provided by the data sources. 

Data sources and data consumers communicate with each other by making 
function calls. The particular functions and their parameters are defined as part of an 
internal version of an application program interface (API). The data consumer 

15 components handle data that is given them through specific calls on their respective 
API, so that information provided through data source components written for 
different applications will not be accepted. This situation provides littie opportunity 
for reuse of data source or consumer components, since each is written to interoperate 
only with a specific instantiation of the other. 

20 In an embodiment of the present invention, an internal mediation layer is 

inserted between the data source components and the consumer components that 
expose data structure in a standardized way. Consumer components are constructed 
to use this common API, which is suitable for expressing an extremely wide variety of 
information types. Data source components can be constructed to deliver the 

25 information they take in this format, or a small amount of code can be written to 

translate the output of another source component into the common format The result 
of the construction is that any consumer component can work with any data source 
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component regardless of the specific nature of the information involved, or whether 
one was anticipated during the design of the other. The common API allows 
consumer components to automatically extract whatever features of information from 
a particular source they are most suitable for displaying or computing with, and also 

5 allows them to utilize all the other features of that information in a generic, 
unspecialized fashion. 

Other embodiments of the present invention comprise: (1) a system for 
representing information such that: (a) a single fixed interface suffices to describe a 
wide range of information types, (b) the information is rendered self describing to an 

10 extent, and (c) relationships between different information elements are expressed; (2) 
an apparatus for allowing this information representation to be employed as a medium 
between data source and data consumer software components; (3) a method and 
apparatus for attaching clarifying material on "intended use" to information so that 
consumer components can handle it more appropriately; (4) a method and apparatus 

15 for providing a context to all information consumption affording control over security 
and visibility of data; (5) a method and apparatus for allowing users to transfer 
information from one consumer component to another through intuitive "drag and 
drop" and M cut and paste" interfaces; (6) a method and apparatus for developing 
enhanced information handling applications based on the foregoing framework; (7) a 

20 method and apparatus for automatically re-representing data from partially self 
describing sources including relational databases, XML streams, and Java software 
objects; (8) a method and apparatus allowing end users using computers distributed 
over a network to collaboratively view and manipulate information; and (9) a method 
and apparatus allowing software components distributed over a network to 

25 automatically obtain annotations on intent and other aspects of encountered data. 

Most aspects of this invention can be implemented in any object oriented 
programming language such as Smalltalk, Objective C, C++, or Java. Certain aspects 
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of it, pointed out below, are especially suited to object oriented languages such as 
Java and Objective C that provide for run time self analysis by programs. However, 
these are in every case peripheral aspects, and the essential parts of the invention may 
be implemented in an object oriented language like C++ without these capabilities. 

5 We will from time to time make reference to a "preferred embodiment" implemented 
in Java, but this should not be taken to be limiting. 

In a preferred embodiment the present invention provides a system and/or 
framework of software components for purposes of aiding development of 
. information-handling applications. The system and/or framework of object-oriented 

10 software components aid the development of applications that read, gather, or receive 
electronic information and allow the display of such information to and manipulation 
by users. These applications are structured in a way so that there are distinct data 
. source components and data consumer components. The crucial features of the 
system and/or framework are the fact that data is seen by consumers only through a 

15 standard, conventionalized interface that incorporates: a breakdown into attributes, 
relationships, semantically-annotated "domain methods", event-broadcasting of 
changes in the foregoing to all registered consumers, metadata for each attribute 
providing certain declarative and procedural information including unit of measure, 
content length, data quality, default value, comparator function, summary function, 

20 validation function, and input/output functions for display and user editing within an 
extensible set of interface modalities, related data items available for each data item 
including those in child or generic relationships, and including the ability to store a 
reference without direct access to the related item itself (it can be reconstructed if 
needed), and contextualization such that the attributes, relationships, events, and 

25 methods available for a data item depends on context (see below). 

In a related embodiment, the system and/or framework includes methods for 
data exposure wherein the system determines automatically which method is 
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employed in any particular case, and the choice is invisible to consumers. Exemplary 
methods such as, a data source component which directly provides the standard 
interface, a data source component which is accompanied by a separate Translator 
component which maps its interface to the standard interface; and a data source 
5 component which is automatically inspected by the system to determine what 
available data fields it has, these are exposed to consumers through the standard 
interface as detailed above. 

In a preferred embodiment, the contextualization provided by the system 
and/or framework is accomplished by delegating the final responsibility for data 

10 exposure to an object termed an "InfoModel" which is able to choose which of the 
available attributes and methods on an object should be exposed or hidden, and is able 
to add additional attributes or methods/ Preferably, the system and/or framework 
further provides facilities supporting transfer of data items between consumers, either 
by user manipulation (cut/paste or drag/drop) or by internal method calls. When a 

15 transfer is initiated, the data item is passed without its contextual characteristics 
(supplied by an InfoModel) to the receiver. The system and/or framework includes 
facilities supporting the automatic integration of service components (generally 
comprising management facilities such as menu provision or running of user dialog 
routines and may or may not have data source provider and/or user interface provider 

20 components) into an application. Integration is handled by a plug-in manager object 
and set of interfaces such that each service provider is given the opportunity upon 
loading to query all components (data providers or consumers) existing within the 
application for whether they desire the service, and if so what parameters they would 
like to pass to it The provider then acts on these responses. "Whenever new client 

25 components are loaded, they will be queried and possibly responded to by all services 
loaded within the application. 
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In another embodiment a system for importing partially schematized or 
structured data sources (such as a database system or an XML document) into a 
system as described herein. Any application written using the disclosed system 
and/or framework can then utilize these data sources through a standard interface. In 

5 particular, a system and/or framework for performing all or a substantial portion of 
the functionality outlined herein - if it is in connection with a framework or 
application implemented using a framework felling under categories as disclosed such 
as an infrastructure for mediating between information sources and consumers and 
rapidly assembling applications using them. 

10 Thus the present invention provides a method and apparatus involving two 

subsystems, one which processes the schema information for a data source to 
determine the type and metadata information for information attributes from the 
source, and one which processes the instance information. Preferably, the schema 
subsystem processes schematic information such as the type information contained in 

15 an XML schema document or the column information available from a relational 
database management system and sets up appropriate metadata and relationship 
structure for information elements, but it does not necessarily create any information 
elements. Optionally, additional annotations can be provided by a user in the form of 
a file specifying how to map attributes in the original data to metadata, relationships, 

20 or domain policy attribute or method definitions. Preferably, the instance subsystem 
processes instance information such as that available from an XML document or set 
of relational database rows, for which corresponding schema information can be 
found, and constructs information elements exposed through the standard interface. 
Data consumers can utilize the outputs of these as if they were custom-created data 

25 sources for the type of information described in the schemas. 

In a related aspect, implementation of the invention as described herein for 
both XML and relational databases is provided In die XML implementation, a built- 
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in data type hierarchy for XML schemas is used to provide types to attributes, and the 
element-subelement-attribute structural hierarchy in XML schemas is used to 
determine relationships between information elements. All documents and schema 
references to other documents are followed up to their sources in order to specify 

5 further attribute or relationship information. A user can optionally specify an XSLT 
(XML Stylesheet Transformations) document that maps the typed data fields found 
from the instance-schema combination into attributes with richer metadata and/or 
references to specific domain policies. In the database implementation, the table 
column heading types from the relational database (date, integer, text, etc.) are used to 

10 provide default type metadata to the attributes of information elements derived from 
table rows of the database. A user can optionally specify a mapping between columns 
or sets of columns into attributes with specific metadata. Furthermore, a user can 
define a sequence of queries for which the results are to result in a hierarchy of 
information elements. For example, for each information clement retrieved from, for 

15 example, Query 1, a parameterized instantiation of Query 2 may be applied to retrieve 
elements which will be exposed as the children of the first information element. For 
each of these elements, a parameterized instantiation of Query 3 may be instantiated, 
and so forth. 

Framework Block Diagram 

20 Figure 1 shows a basic block diagram of a framework that is implemented in 

accordance with the present invention. The framework 100 of Figure 1 can be used to 
develop, for example, an information-handling system or application wherein data 
source components 102 and data consumer components 122 are separate and 
independent from each other but can communicate and share data. The framework 

25 1 00 described herein shall be called the extensible information system (XIS) 
framework. 
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From a developer's perspective, a modular piece of software that handles part 
or all of the data intake or retrieval function is a data source component 102. A 
modular piece of software that handles part or all of either data computation, 
transformation, presentation, or display of information is a data consumer component 
5 122. A conventional information-handling application such as a graphing program 
comprises two major components: one side handles the intake of information from 
storage devices, the network, or user input, and the other side handles the display or 
presentation of the information. There may also be parts of the application that 
perform computations or transformations on the information before it is displayed. 

10 XIS Framework 

In the XIS framework 100 constructed in accordance with the invention, there 
may he more than one data source component 102 (also referred to as a source, data 
source, source component, and source object) and there may be more than one data 
consumer component 122 (also referred to as a consumer, consumer object, consumer 

15 component, and data consumer). The data source components 102 provide 

information to other components within the XIS framework 100 via a mediation layer 
1 12, while the data consumer components 122 use the provided information. 

The source components 102 and consumer components 122 that comprise the 
XIS framework 100 are configured such that they communicate with each other in a 

20 manner that is supported by the programming environment in which the framework 
exists, typically by making function calls, via the mediation layer 112. In one 
embodiment, the mediation layer 112 consists of a group of application programming 
interfaces (APIs) or class libraries that define a common format for data exchange, 
establishing an information exchange standard. Thus, data source components 102 

25 configured for a different system, application, or framework may still be used within 
the XIS framework if they are "wrapped" in a predetermined way or are suitably 
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modified, as will be known to those skilled in the art, such that they conform to the 
requirements of the data exchange interface of the mediation layer 1 12. 

A relatively simple block of programming code may he produced to translate 
the output of a data source component 102 into the common format as defined by the 
5 . mediation layer or API 112. in this way, any consumer component 122 may work 
with any data source component 102 regardless of the specific nature or type of 
information involved and regardless of whether the data source component was 
known or anticipated during the design of the data consumer component. Because of 
the XIS framework described herein, the data consumer 122 may also extract 

10 whatever features or sets of information that it needs or can process from one or more 
data source, thereby enabling the data consumer to utilize features and information in 
a generic unspecialized fashion. 

The mediation layer 1 12, which is between the data source components 102 
and the consumer components 122, exposes the data structure of the data source 

15 components 102 in a manner that is common for the framework, preferably through 
: an API interface. Data consumer components 122 are constructed to use this common 
API, including utilizing the exposed data structure. The data consumer components 
122 are suitable for expressing an extremely wide variety of information types. In 
addition, the data consumers may be constructed to deliver the information received 

20 from the mediation layer to another data consumer component, or to output the ■ 
information received for display. 

Data consumer objects 122 are application or software objects or components 
that use data, or may be said to consume it. Examples of data consumers include 
display programs that display data m tabular format, in graphical mode, in 

25 • organizational chart mode, spreadsheet mode, timeline mode (similar to files in the 
format of fee "PROJECT" application from Microsoft Coiporation), and the like. 
Data consumers may be desktop based, web-based (Internet-based), distributed 

20 



WO 02/46916 



PCT/US01/4S418 



architecture, interpreted programs, and the like. Data consumer components within 
the XIS framework may provide display, computational, or interactive facilities. In 
the present description, such specially configured data consumer components are 
referred to as "INFOBEAN" objects, as available from the assignee of the present 
5 invention, Polexis, Inc. of San Diego, California, USA. Those skilled in the ait will 
understand how to extend the framework 100 to produce desired applications, in view 
of the description herein. 

Figure 2 shows additional details of the mediation layer 1 12 in the framework 
100. In the framework 100, four special types of interfaces may be exposed to the 

10 data consumer components 122. These four interfaces include Domain Definition or 
Domain Policy 202, Relationship 210, Attributes/Metadata 214, and Change Event 
216. In one embodiment, change events are registered within the XIS framework 100. 
These interfaces may be exposed, for ©cample, through class and object libraries that 
may be developed for the XIS framework. With these pre-defined class and object 

15 libraries and APIs, developers of data source components 102 and data consumer 
components 1 22 may independently develop their own source and consumer 
components, thus facilitating development of information-handling applications or 
systems. An example of a class that may be implemented or written in the mediation 
layer to facilitate development of source and consumer components is illustrated in 

20 Figures 33 A to 33P, which show details of a sample class called ContentlnfoBean. 
Domain definitions or policies 202 (also referred to as domain objects or 
simply domains) are optional within the XIS framework 100. If defined, the 
corresponding Domain methods 212 for such policies are exposed to the data 
consumers 122. Other information about the domain policy may also be exposed, 

25 such as Attributes/metadata 214 and Relationships 2 10 for that particular Domain 

Policy. Attributes/Metadata 214, Change Events 216, and Relationships 210 may also 
be exposed within the XIS framework 100, even if domain policies are not defined. 
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Relationships show the relationship between data source components. 
Containment, hierarchies, and ad-hoc relationships, for example, may be shown. 
They may be expressed as "members of* and references. Relationships are thus 
recognized and may be obtained accordingly, as shown in Figure 14 described further 
below. 

Change events may be used to ensure that all consumer or source components 
that have an interest in another source component's data are notified when changes 
occur. Changes may be notified when attributes, members (or containers), or 
references (or referrers) are added, updated, or removed and when values are changed. 

Once a data consumer component 122 obtains a reference to a data source 102, 
the data consumer component may obtain access to these interfaces 202, 210, 212, 
214, 216 through method calls in accordance with the programming environment of 
the host computer system. The data consumer 122 obtains such a reference typically 
in preparation to consume or use information from at least a particular data source 
102. Examples of such consumer component method calls include: 
get attributes; 

get member and container information elements; 

get referred and referring information elements; 

get unique ID and selection state; 

add and remove instance specific attributes; 

register to be informed of changes to attributes or relationships; 

and 

invoke method calls of a semantically annotated type, described 
below. 

These types of method calls will be familiar to those skilled in the art and familiar 
with the programming environment of the host computer system. 
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Figure 3A is a schematic diagram showing the information about data source 
objects that is exposed by the mediation layer 1 12 in Figures 1 and 2, as well as the 
services available within the XIS framework 100. In accordance with the invention, 
data source components are wrapped with an object that exposes the interface 

5 information for the data source to data consumers through the mediation layer. 

In the preferred embodiment, the wrapper around each data source is an object 
provided by a class called InfoModel. As shown in Figure 3 A, a data source 
comprising a raw data item 351, via the APIs 1 12 as described above, offers a variety 
of information, as shown in the blocks 354, 356, 358, 360, 362, through which data 

10 consumers may gain access to the data source. The information represented by the 
blocks 354, 356, 358, 360, 362 is exposed or may be contained within an InfoModel 
350, which provides an information space for all information available in the XIS 
framework 100 for the wrapped data source component. In one embodiment of the 
invention, the data needed by data consumers are accessed via such InfoModels (such 

15 as further illustrated in Figure 28). The wrapper provided by the InfoModel is called 
a LeifDataltem object 352. Thus, the InfoModel is an interface that permits data 
sources and data consumers of the XIS framework to independently share their data. 
In this way, the methods 360, domains 358, metadata 354, relationships 356, and 
other information of a data source object are thus exposed using the InfoModel object, 

20 which may be said to exist in the mediation layer 112, which sets up contexts for data 
consumption. The XIS framework also provides additional data services through the 
mediation layer, such as the Plug-In Service 264 and BeanContext Service 266 
indicated in Figure 3 A. These services provide the functionality listed in then- 
respective boxes 364, 366. Other data services may be provided, as desired. 

25 The InfoModel object provides a context for information access, ie., context is 

instantiated through the InfoModel concept In this way, security may be enforced, 
considering that the conceptual or real "end-user" accessing the information is known 
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and thus the underlying data source may be forwarded correctly. Furthermore, 
through this InfoModel concept, an embodiment of the framework may be 
implemented such that attributes and methods may be added or removed by the 
framework user. Original attributes and methods in one context may also be 
5 overridden. 

An attribute is any property of an object In one embodiment of the invention, 
an attribute may be coded with an " AttnT>uteDescxiptor". An AttributeDescriptor is 
provided by the object or its Translator to describe a property of the object using 
TypeMetaData, e.g., how to display it, how to edit it, its permitted ranges, and the 

10. like. Translators map data source-specific structures and types to an XlS-generic 
representation. Translators are further discussed below. Attributes may also be 
defined using Java introspection or reflection, as discussed further below. 

Dynamic attributes may also be exposed within the XIS framework 100. 
These attributes are attributes that are exposed during run time, such as, for example, 

15 a database query wherein each column is an attribute revealed at run time. The 
mediation layer has a mechanism that captures such information. In the preferred 
embodiment, die XIS framework operates in conjunction with a database management 
application, so that the mediation layer utilizes run time database query mechanisms 
that generate metadata of the data object, such as data table column headings, data 

20 types, and the like. Such mechanisms may be provided, for example, by SQL queries 
and the like. In one embodiment, data consumer applications using the XIS APIs are 
unaware of whether an attribute for a data item is obtained dynamically or statically, 
so that the process is transparent to the application user. 

A domain is a collection of sernantically meaningful attributes and method 

25 signatures grouped by their common domain of interest. Examples of domains 

include a Display Domain (a domain that describes how to display information) or a 
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Geo Domain (a domain that specifies how to handle geographic information). 
Domains are further discussed below. 

The contextualization provided by the XIS framework system is accomplished 
by delegating the final responsibility for data exposure to an object termed an 

5 "InfoModel", which is able to choose which of the available attributes and methods of 
an object should be exposed or hidden, and is able to add additional attributes or 
methods. Preferably, the system and/or framework further provides facilities 
supporting the transfer of data items between data consumers, either by user 
manipulation (cut/paste or drag/drop) or by internal method calls. This supports data 

10 sharing among data consumers. When a transfer is initiated, the data item is passed 
without its contextual characteristics (which are supplied by an InfoModel object) to 
the receiver, i.e., only non-contextual information is transferred In this way, the 
source data may remain unchanged. 

As illustrated in Figure 3 A, a FieldMetaData file 354, a type of metadata, is 

15 used to represent sorting, subset, and visibility criteria for an attribute. This is further 
explained below in conjunction with Examples 1 to 5, wherein subsets of data are 
shown depending on whether "All Attributes" or "Preferred Attributes" are shown. In 
one embodiment of the invention, default behavior method of domain policy attributes 
may also be overridden. Within this framework, context-specific special attributes for 

20 flagging whether a data item should be visible or not (e.g., can be used for display 
filtering, including file XIS value slider, tree checkboxes in the map view, etc.) may 
be defined This may be achieved through the mediation layer by utilizing a user 
interface to modify display processing for the data item. Furthermore, a selection 
attribute that is a context-specific special attribute for flagging whether an object is 

25 "selected" (and typically should be highlighted) may also be defined. Selected pieces 
of information are often shared among views (context-specific, though), and certain 
operations may be performed on the set of selected objects in a given context 
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The InfoModel objects as described above know how to leturn a data item (a 
LeifDataltem) given a corresponding taw data source identifier. The InfoModel also 
manages these data items- As indicated in Figure 3 A, an InfoModel may contain one 
or mere LeifDataltem objects, each of which provides an interface to a raw data item. 

5 An application developer may use an InfoModel object 350 to get a LeifDataltem 
object 352 in order to use the XIS APIs for accessing the underlying data source in a 
generic fashion. If two different data consumer components ask for a data item (e.g., 
a LeifDataltem) from the same InfoModel for the same raw data source, then both 
data consumers will get the same instance of the LeifDataltem object. InfoModel 

10 objects may also be nested as indicated in Figure 3B. 

Information becomes normalized in the XIS framework so that any application 
can use an object's information by getting attributes and relationships dynamically at 
runtime. Therefore, instead of hard-coding a visualization program to a specific type 
of object, the visualization looks for the attributes it needs to perform its function. 

15 Thus, the developer of the data consuming module may obtain the information needed 
from the XIS LeifDataltem class, which wraps raw data item objects and exposes 
them to the data consumer through uniform APIs. The visualization can access all the 
information exposed, through the XIS APIs and techniques, as needed If the data 
source provides AttributeDescriptor objects or translates the properties to domain 

20 attributes, then the information can be interpreted more intelligently in domain- 
specific ways. In one embodiment of the invention, the XIS framework also offers 
APIs and a programming model (or design pattern) that extends Sun's JavaBean 
pattern with XIS information awareness. These extended JavaBeans comprise 
"smarter JavaBeans" that are provided in the XIS framework as the specially 

25 configured INFOBEAN objects and, like JavaBeans, INFOBEANs can be visual or 
nonvisual components, and can be graphically combined in any standard Java 
development environment. 
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InfoModel Class Objects 

In one embodiment, there are four types of InfoModels in the XIS framework: 
BaselnfoModel : * 

A single BaselnfoModel is required because it is responsible for creating and 
caching every BaseDataltem (data item) wrapping a Java object (the raw data item 
object). The BaselnfoModel object holds any object used as a LeifDataltem until the 
data item is no longer needed (i.e., until it is no longer strongly referenced). 

SelectablelnfoModsl ; 
4 A super class of BaselnfoModel, this InfoModel delegates to any other 
InfoModel (typically the BaselnfoModel), and creates SelectableDataltems (data 
items that are selectable). The SelectablelnfoModel objects add a selected Boolean 
attribute and delegate to the LeifDataltems from the prior InfoModel. Since the 
BaselnfoModel is a SelectablelnfoModel, all LeifDataltems have a selected attribute. 
This is true because any LeifDataltem is either in the BaselnfoModel itself, or is in an 
InfoModel that is nested in the BaselnfoModel and, therefore, inherits the selected 
attribute from the BaseDataltem. Additional SeJectablelnfoModels can be 
instantiated to create independent contexts for selection state, independent of other 
InfoModels. 

AttributeFactorylnfoModel : 

This InfoModel allows AttributeFactoiy classes to be registered so that every 
time a LeifDataltem is created, it enables attribute factories to add additional 
attributes to each LeifDataltem. 

InfbModelSubset 

A super class of SelectablelnfoModel and AttributeFactorylnfoModel, this is 
the simplest InfoModel. It delegates to its parent InfoModel and creates 
LeifDataltems that wrap those XIS data items from the other InfoModel. This 
InfoModel does not automatically add any attributes to the LeifDataltems it creates 
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and manages, but simply provides a context in which data items can be managed. 
Each InfoModel "layer" provides a context in which additional attributes can be 
defined, or existing ones can be overridden. Figures 34A to 34D list an exemplary 
Java package that Ksts various classes. Figures 35 A to 3 5D list the InfoModel 
5 interface. An interface is a contract in the form of a collection of method and constant 
declarations. When a class implements an interface, it promises to implement all of 
the methods declared in that interface. 
Exposing Data 

Figure 4 is a diagram showing how information from source components may 

10 be exposed to data consumers using the mediation layer 1 12. The Attribute/Metadata 
interface 214 of Figure 2 exposes a data item 440, 442 as a set of attributes, each of 
which carry a value and a set of metadata that describes the value* A data consumer 
component 420, 422, 424 may obtain information from one or more data items. 
Similarly, a data item 342 may be used by more than one data consumer 422, 424 via 

15 the mediation layer or API 1 12. The information blocks 460, 461 show the 
information available to data consumers. 

A data source component 102 may comprise a data source interface (DSI) 
object 412, 414. A DSI object 412, 414 provides a conceptual way to encapsulate 
objects that provide data to the XIS framework 100. A class of a DSI object does not 

20 have to extend or implement any interface. Data is created (instantiated) in DSI 
objects to thereby encapsulate the data and make it available to other objects. The 
DSI itself may also be a data item that simply contains other data items (members). 
The data may be generated internally or extracted from an external source such as a 
database or across a LAN. In addition to creating the data, DSI objects are also 

25 responsible for maintaining and controlling data, such as removing and updating the 
data themselves if such changes are observed in the underlying data used by the DSI 
to create the data. Property change events (216 of Figure 2) may be used by DSIs to 
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communicate changes observed in the original source data items to the listening data 
consumers. 

Any Java object may be a data source component. The Swing JButton, for 
example, is usually a transient object, and not typically retrieved in an information 
5 system. The Swing JButton, however, may still be a data source, if so desired. 

INFOBEANs as stated above are data consumer components 420, 422, 424. 
They are specially configured objects that behave like JavaBeans that process and 
manipulate data in a generic fashion. They are also capable of interpreting and 
optionally displaying XIS data items. INFOBEANs use the XIS framewoik API's to 
10 gain access to information about data items. 

As previously stated, any Java object may become a dab item 440, 442 within 
the XIS framework 100. To make a data item out of JSlider (javax.swing JSlider), it 
simply must be added to an INFOBEAN (data consumer component). Table II below 
provides programming code that makes a data item out of javax.swing.JSlider, thus 
15 exposing the information blocks 460, 461 shown in Figure 4. 



Table H 

Jslider slider = new Jslider(0,100,50); 
tablelnfoBean.addRawDataltem(slider); 



The first line of code creates a data item out of JSlider. The second line of 
code adds the JSlider created in line 1 to the TablelnfoBean object (an INFOBEAN). 
20 In this framework, JSlider knows nothing about the XIS framework, however, al! its 
attributes are exposed, to be used and modified. 

There are basic steps that must be performed when creating a DSL First, 
before any code is actually written, a determination must be made as to how the 
original data or data source is to be obtained (e.g., will it come from a database, a flat 
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file, an EJB (Enterprise JavaBean), read from a socket, etc.). This step is performed 
prior to and independent of coding the DSI. Once the data source has been 
determined* it must be decided what attributes of the data source should be exposed 
within the XIS framework. 

5 The DSI component within the mediation layer of the XIS framework has the 

capability of exposing the attributes of a data source. In one embodiment, assuming 
that the data source is a Java object, the attributes to be exposed are determined 
through Java introspection. Introspection is a way to determine a bean's properties, 
methods, and events. Those skilled in the art will understand that a bean is a reusable 

10 software component, which may be combined to build applications. In this scenario, 
no additional code in the consumer component needs to be written. Although 
convenient, this approach is limiting, as it does not allow control over which attributes 
are exposed, and does not allow the user to define custom visualization components or 
express semantics. Furthermore, it requires the Java object to conform to the 

1 5 JavaBean design pattern. 

Another approach to determining which attributes of a data source should be 
exposed involves writing new code. This approach embeds XlS-aware code directly 
into the Java object. This allows the component developer to directly specify details 
such as the attributes (e.g., via AttributeDescriptor) to be exposed along with their 

20 metadata, the Domains to which the DSI subscribes, which Domain methods are 
exposed with what implementations, and more. Writing new code enables greater 
control over the data item (as opposed to the introspection-only case) and provides 
more flexibility in dealing with any Java object rather than just JavaBean objects. 
One limitation of this approach is that the relationships between data items may not be 

25 directly specified. 

Another approach for exposing attributes is to create a Translator class. An 
application developer may place any of the XlS-aware code for exposing attributes, 
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Domains, and the like in this class, as specifying relationships to other data as 
members or as references. This is described further below, in conjunction with the 
description of Figures 21 to 23, 

Referring back to Figure 4, a data consumer 420, 422, 424 may access a data 
5 source via a data source interface (DSI) object defined in the mediation layer 1 12. 
Communication between the DSI objects 41 2, 414 and data consumers 420, 422, 424 
in the framewoik 100 is mediated through a set of application programming interfaces 
(APIs) 112 that remain independent of the actual contents and types of the data 
sources. Such APIs are contained in class libraries. 

10 Using the framework 100, a data consumer 420, 422, 424 (for example, an 

INFOBEAN as shown in Figure 6B) may be able to use heterogeneous data sources 
and, thus, eliminate the need to write a particular display software object for each 
particular data source. Within this framework, any data consumer object or 
application may use the data source object's information by getting attributes and 

15 relationships dynamically at run time. Instead of hard coding a visualization to a 
specific type of data source component, the visualization object or data consumer 
looks for the ^attributes it needs to perform its function. Thus, in this framework, 
developers for source and consumer objects may work independently of each other. 
The DSI object may create any data structure containing members and 

20 references, and may expose any part of that data structure to the framewoik or system 
100 if it is desired. Since there are no requirements involved to be a data source, a 
visualization bean can also be a data source. The data source can consume data from 
other data sources, and can create new data based on what it has learned. For 
example, DSI objects may be coded to use data source from an RDBMS, e.g., systems 

25 such as provided by Oracle Corporation of Redwood Shores, California, USA and as 
provided by Microsoft Corporation of Redmond, Washington, USA through their 
"ACCESS" application or SQL Server. DSI objects also may use data sources such as 
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XML format data, tabular data (e.g., spreadsheet data such as spreadsheet files in the 
format of the "Excel" application from Microsoft Corporation), email, schedules (e.g. 
schedule data in the format of the "PROJECT" application from Microsoft 
Corporation), data following the SNMP (simple network management protocol), and 
5 theHke. 

Objects created by DSIs axe considered to be raw objects in the XIS platform. 
These raw objects become noimalized objects within the XIS framework when they 
conform to the mediation layer or the API 1 12. In one embodiment, when these raw 
objects are added to an XlS-enabled environment, the XIS framework wraps them 

10 with a normalized object called a LeifDataltera (see Figure 3 A) and holds the data 
item in one or more InfoModels. The raw data item could be a simple Java object 
(that does not know anything about XIS) or it can support XIS with direct references 
to AttributeDescriptors and other metadata that are recognized by XIS. The 
mediation layer is implemented in software and runs in-process. It is also exportable 

15 to serve as a distributed middleware if required by a given application. 

An attribute is any property of an object. An attribute 474, 475 typically 
includes identity (ID number) 476, 477, name of the attribute 478, 479, value 480, 
481, and the metadata type or Type Metadata 482, 484, and a description 484, 485. 
Attribute names 478, 479 may be the table column header or field name in an 

20 RDBMS. The description of the attribute 484, 485 may be plain text that explains the 
attribute. The value 480, 481 may be expressed as a number, string, or other basic 
data type, or may be expressed as a complex, structured obj ect in itself. 

Referring back to Figure 2, the Attribute/Metadata interface 214 provides for 
fine-grained exposure of an information element or data item 440 442 (Figure 4); by 

25 "fine-grained* is meant that the data item is broken down into a number of aspects or 
characteristics (the "attributes") which are simpler data elements. These might be 
numerical values, strings, arrays, or anything else that can be represented by a 
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software object (but is simpler than flie original element). If a data consumer 412, 
414 is not able to handle the entire data element, it may be able to handle some of its 
attributes and therefore may be able to do something useful with it, unlike most 
systems providing interfaces for data integration, which require the entire interface to 

5 be implemented to enable any data usage. 

The Attribute/Metadata interlace 214 also makes each attribute self-describing, 
to a limited extent In accordance with the invention, a data consumer designed 
without regard to a particular type of attribute is still able to display and perform 
limited operations with those attributes by using the metadata types. For example, a 

10 data consumer object or INFOBEAN, which displays an X and Y chart of cost of 
living (expressed as a numerical value) versus geographical location (expressed as a 
territory or state character string, e.g., "California 11 ), may be used to display a different 
set of data contained in another data source component or data item, so long as the 
metadata types of the different sets of data are compatible with the X and Y chart In 

1 5 particular, a data consumer component that renders and edits information may still be 
executed, the default value substituted in cases of absence, and statistical 
summarization performed, even if the data consumer component is processing a 
different data source component Other operations are possible and additional 
metadata may be provided by developers for any identified classes of information 

20 elements (such as number, array, geographic entity, etc.) desired. Because of this, 
data consumer developers may identify the type of auxiliary information or 
procedures provided by the consumer component and then define the interface 
according to which other developers creating data sources should provide or expose 
their metadata. 

25 In one embodiment, any property or attribute of an object may be defined with 

an AttrituteDescriptor programming code. When a data source object is enabled 
within the XIS framework, the computing system automatically creates 
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AttributeDescriptors for JavaBean properties and for some public properties. A 
JSlider object, for example, is a JavaBean. JavaBeans have properties feat are defined 
by the get<property> and set<property> methods. If the object is a JavaBean and 
provides a Beanlnfo, then it will be honored and treated according to the JavaBean's 

5 specification for Beanlnfo classes. Only properties listed in the Beanlnfo appear as 
attributes. If metadata types, further discussed below, support the property's type, 
then they appear as attributes for that data item. Any properties that do not have 
TypeMetaData support become data items themselves (using the same reflection and 
introspection rules) and are listed in the data item's reference array, retrieved by the 

10 LeifDataltem getReferencesO method (i.e., a method to obtain the references). 

Translators translate various data item classes, thereby enabling seamless integration 
of various data items without code modification. Translators may also be added to 
augment object reflection and introspection, i.e., by developers directly specifying the 
properties of an object 

15 Table III below lists exemplary programming code to define attributes. Table 

YTT shows how to define a SIZE attribute. 



Table III 

public static AttributeDescriptor SIZE; 
static { 

AttributeDescriptorFactory factory = 

AttributeDescriptorFactoiy.getAttributeDescriptorFactoryO 
SIZE - factory .createAttributeDescriptor( 
"size", Your.class, 

new NumericTypeMetaData( M Size", long.cIass, 
UnitsOfMeasure.0YTES, 6)); 
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} 



Metadata are data or information regarding data, for example, data type, field 
name, length, value restriction, color, and the like. In practice, metadata are used to 
define the structure and meaning of data objects in tools, databases, applications, and 
other information processes. The data type metadata 482, 483 encompasses both 
procedural and declarative information, including (as appropriate for the value) but 
not limited to the following: 

unit of measure (from the provided unit of measure software 
object, converters to/from other units are accessible); 
content length; 

default or maximum character length or precision of numbers; 
data quality (a rating given by the provider of the data); 
default value (given by the provider of the data type); 
constraints (e.g., numeric range or list of acceptable values); 
formatting; 

comparator function (a procedure which takes two items of the 
data type in question and returns whether one is to be ordered 
before, after, or the same as the other); 

validation function (returns true' or 'false 1 depending on whether 
the value for the attribute passes a certain test or set of tests, tests 
are developer-definable based on an interface which takes a 
software object providing a value and returns a Boolean value, 
but several reference implementations are provided, such as one 
to determine whether a number is within a specified range; 
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in the property sheet (and the display button "Apply" is pressed), the chart • 
automatically updates. Similarly, right clicking on the part of the chart corresponding 
to a data item enables a user to bring up its property sheet. In this embodiment, this 
kind of coordination is maintained automatically within the XIS framework through 

5 the use of the JavaBeans event mechanisms. It should be noted that when the 

application is run or executed, the color of the chart does not match the one set in the 
property sheet. This is because, although the PropertySheet recognizes that any field 
of type "java.awt Color" is displayable and editable as a color, the chart has no way of 
knowing which color field (if there are more than one) should be used This may be 

10 solved, however, within the framework by using standardized Domain Attributes. 
In one embodiment of the invention, Translators are used within the XIS 
framework. As described earlier, a DSI exposes data information within the XIS 
framework for data consumers to use. Java reflection and introspection may be used 
to obtain attributes specified in simple objects and JavaBean, respectively. The XIS 

15 framework first searches for a Translator class for the data source object Translators 
are therefore optional considering that the attribute values and attribute descriptors 
may directly be obtained from an object Translators may also be used in order to 
keep the object's class simple so that it is capable of being used in non-XIS 
environments. 

20 In an embodiment, Translators are somewhat similar to the Beanlnfo class in 

JavaBeans. Like the Beanlnfo class, the name of the class must begin with the name 
of the data class followed by "Translator". For example, a DSI class named 
PlanObjectjava would have a corresponding Translator class 

PlanObjectTranslator.java. Also, similar to Beanlnfo classes, Translators must reside 
25 in the same class space in which the DSI is located. For special circumstance cases 
such as non-localized objects or custom Translator definitions, a Translator registry, 
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e.g., TranslatorRegistry, may be used to register a Translator for a given data item 
class. 

Table VTH below shows an exemplary code to register a Translator within the 
XIS framework. 



Table Vm 
// register the translator for File objects 
TmnslatorRegistry.getTranslatorRegistryO 

,registerObjectSchema(PlanObject.class, 

PlanObj ectTranslator.class); 



The above code, as well as all code discussed herein, is provided to illustrate 
the functional behavior described herein. One of ordinary skill in the art will be able 

10 to produce the code, for example, to create classes, objects, APIs to affect this 
Translator registry. 

When the value of an attribute is requested from a data source component, 
using the mediation layer, the value from the attribute methods specified in the 
Translator, if any, is exposed If the Translator does not exist, then the method in the 

15 object is invoiced, i.e., the get+attribute method within the data source object. The 
Translator may directly invoke the object 1 s methods as well. The Translator may also 
be used to wrap legacy code. For example, if the object class is a legacy code, which 
may not be modified, and has a color property, a Translator may be written to return 
the value of the color, for example, for fee DisplayDomain.color attribute. In this 

20 way, the information may be accessed without modifying the original legacy code. 
The data in the data source object in effect has been normalized or tailored to the 
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domain policy specified. The XIS framework in this embodiment provides the ability 
to integrate existing data item classes without modifying them. 

To integrate a data item class into the XIS framework, an accompanying 
Translator class should be provided. In this Translator class, the data source 
5 developer provides code that reaches back into the data item's class to expose its 
properties. It also serves as a way of normalizing access to these properties by 
imposing a common interface for all Translators to implement. 

Translators have two primary functions: 

(1) Translators provide an intermediate method from the caller of an attribute 

10 "get" or "set" method to the data source object, enabling a developer to translate the 
value from its internal representation to a representation understood within the 
framework, particularly, by the data consumer components. For example, an object 
may store a default color as a string color name, but the Translator may convert that 
color to a java.awtCoIor object 

15 (2) Translators also enable a developer to define attribute types more precisely 

(e.g., via AttributeDescriptor code, which provides detailed TypeMetaData and may 
map attributes to specific domains). This resolves any ambiguity in the attribute type. 
It should be noted that reflected properties that are converted into XIS attributes carry 
minimal semantics, which contributes to the usefulness of the XIS framework. For 

20 example, "float getDegrees()" by itself does not imply whether it provides an angular 
measure or a temperature measure, nor does it imply that the valid range is from 0 to 
360 or from 0.0 to 2.0 pi for angular measures, or distinguish between Fahrenheit, 
Celsius, or Kelvin for temperature measures. 

Translators also enable developers to convert objects that do not follow the 

25 JavaBeans get/set API design pattern. For instance, a data item could be implemented 
as a mapping of attribute names to values (e.g., String, Integer, Double, and Boolean). 
The Translator may map actual XIS attributes to these key/value combinations, 
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making XIS data items appear as if they were generated from the more typical 
JavaBeans-style objects. Example 3 shows how a Translator may be implemented in 
the XIS framework. 
Example 3 

5 Example 3 application is contained in three source files listed in Figures 21, 

22A, 22B, 22C, 23A, 23B, 23C, and 23D. The resulting outputs are shown in Figures 
24Aand24B. 

Example 3 functions similarly to Example 2 above, but enable finer control 
over the data item attributes exposed within XIS. In particular, the HelloWorld object 

10 is explicitly wrapped in a Translator rather than simply feeding it to XIS and letting it 
rely on reflection to display and manipulate the data. This allows some properties of 
the raw data item to be hidden, and allows other ones to be better "understood" within 
XIS. The HelloWorldTranslator java file contains the Translator. 

Referring to Figure 21, the property change event-handling portion of code 

15 1 506 found in Figure 1 8 A has been removed from the set methods. These functions 
are now handled in the HelloWorldTranslator class (Figures 22A-22C), which is 
registered with XIS by the TranslatorRegistry static call at the beginning of that class. 

Referring to Figures 22A to 22C, this file contains the HelloWorldTranslator 
class 2202 that wraps the HelloWorld object When an INFOBEAN encounters a raw 

20 data item, it ultimately accesses the raw data item through a Translator's methods, if a 
Translator exists. In one embodiment, all Translators are subclasses of the 
com.xis.leif.im.Translator class, which provides an infrastructure that facilitates the 
use of attributes already defined or set-up in an XIS Domain. Such attributes have 
type metadata predefined for them, and many XIS INFOBEANs automatically access 

25 and utilize the metadata and the attributes themselves. 

The first member variable 2204 of the HelloWorldTranslator class lists the 
predefined XIS domains from which attributes are taken. In order to use an attribute 



63 



WO 02/46916 



PCT/US01/4S418 



not in one of these domains, it may be necessary to provide a separate metadata for it. 
The second member variable 2203 defines an array, which lists auxiliary information 
on the fields, in this case, whether they are displayed by default in the property sheet 
display. The getFieldMetaDataArray method 2206A and 2206B fills this array, if 

5 necessary, with the default metadata for the fields that are exposed by the get and set 
methods further listed below in the source file. The exception to the defaults is that 
the "course" attribute 2208 is not visible, i.e., it is not displayed under the "Preferred 
Attributes" on the property sheet It is displayed, however, when the "All Attributes" 
option is selected. Other things that may be set (but are not in the source file) include 

10 the sorting order and rank when multiple data items of this class are listed together, as 
in a table. 

The ensuing get and set methods 2210 define the attributes that the rest of the. 
XIS objects can see. In general, this refers to the enclosing raw data object, but this 
need not always be the case. For example, here, the HelloWorld's integer Value 1 

15 property is map to the 'speed* attribute, which takes its metadata and its type (double) 
from the Movement domain 2212. The Movement domain has previously been 
defined. By handling conversions within the Translator, the rest of XIS "never 
knows" that there is really an integer value underneath. 

All change event propagation is handled through the request objects passed 

20 into the set methods 2214. Similar to Example 2, all XIS objects using the same data 
item are notified of the change. 

Referring to Figures 23A through 23D, the TestHarness code is largely 
unchanged from Example 2, but at the end it includes a separate class that 
demonstrates how attributes maybe altered on a data item that includes a Translator. 

25 In general, the procedure is to obtain, first, the LeifDataltem corresponding to the raw 
data item, then a "domain wrapper" that wraps this and enables access to attributes 
that come under that domain. Internally, the domain wrapper calls methods on the 
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Translator, but externally it presents an interface to the developer that depends only 
on the domain and not on the particular LeifDataltem being wrapped. 

The code in the Accelerate class is a standard thread implementation that uses 
the wrapper to successively change the HelloWorld data item's speed attribute. In 

5 other embodiments, this attribute may be altered by any portion of the program that 
has access to the data item. Because the wrapper eventually calls the Translator, the 
change events are propagated appropriately. 

The Example 3 application, similar to Example 2, displays two windows-a 
property sheet and a chart. Example 3 shows that the property sheet may be made to 

10 display more properties (in this case, the "course" attribute) by selecting "All 
Attributes" from the top menu, which ignores the "preferred" setting in the 
FieldMetaData. The attributes all have reasonable names, which come from the 
metadata stored in the domains. Finally, if the "Pen Color" attribute is edited, the plot 
changes color accordingly. This is because ihe Chart INFOBEAN recognizes and 

15 uses the "Pen Color" attribute from the Display Domain if it finds one on the data 
item. Because of the various wrappers employed, it does not matter what kind of 
object is eventually underneath or what other attributes it has; as long as the "Pen 
Color" attribute is found, it will be used. 
Example 4 

20 Example 4 contains two source files namely HelloWorld and TestHarness. 

Figures 25 A to 25C list the HelloWoridjava source file. This example shows 
translation without a Translator class. The resulting output is a property sheet 
INFOBEAN and a Chart INFOBEAN. Figure 26 shows the property sheet InfoBean, 
but the ChartlNFOBEAN is not shown. The HelloWorldTranslator.java file from 

25 Example 3 is eliminated Similar to above, the HelloWorld.java file has been marked 
such that changes from Example 3 are marked by open and close commented braces. 
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The Java source files enable some of Hie same fine control over the attributes 
exposed within XIS (see Example 3) without using a separate Translator class. If a 
developer has control over the Java code for the data source, the overhead of using a 
Translator may be eliminated by building some of its functions directly into the data 

5 source. It may, however, still be desirable to use a Translator because this avoids 
building any XlS-specific code into the JavaBean created and enables the code to be 
• more streamlined for use in non-XIS contexts. 

Figures 22A to 22C contain the Hello World code, which include some of the 
code from Example 3, with some additional code for exposing attributes and * 

10 providing field metadata as the HelloWorldTranslator class in Example 3. In fact, 
almost everything may be done from within this data item class that could be done 
with a Translator except for two things. First, attributes cannot be hidden from XIS-- 
everything with a get() method is exposed. Second, Translators may be used in 
conjunction with security features, for example, embodied in the XIS framework to 

15 restrict access to visible properties in a generalized fashion across all data items. 

The first portion of code 2502 provides methods foT XIS to obtain information 
on which data item properties have attribute information provided for them. The XIS 
components first introspect on the data item to find its properties, then try to call the 
get(property name)Descriptor for each property. For those instances where this fails, 

20 the XIS component may provide its own attribute descriptors where it recognizes the 
type of the attribute. For example, the property sheet recognizes Color. Numeric 
(various subtypes), Date, and String attributes. The next portion of code 2504 
initializes a PropertyChangeSupport instance, because property change events must be 
handled here, similar to Example 2. 

25 Following this are several methods unchanged from Example 3, but the set() 

methods have been altered to resemble those from Example 2 in which property 
change events are fixed. Next, there are several new get() and setQ methods which 
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expose the properties with the same names as the Translator did in Example 3. These 
names correspond with the getAttributeDescaiptoi methods listed above in the code, 
and the XIS components interpret them accordingly. These properties show up as 
preferred attributes in the property sheet, whereas those properties without 

5 corresponding attribute descriptors become nonpreferred attributes . 

The portion of new code 2506 following this provides field metadata for this 
raw data item. This program code is almost identical with those in the Example 3 
HelloWorldTranslator, except that both the variable and the method arc now static, 
and the "Course" attribute removed to reduce clutter. 

10 The TestHarness file for Example 4 is generally unchanged from Example 3, 

except the code to register a Translator is removed. The portion of program code 
2302 ill Figure 23 A is removed in this example. 

This Example 4 application is largely similar to Example 3, except that if the 
"All Attributes" option is chosen under the property sheet, then the previously 

15 unexposed "value", "myColor", and other attributes appear. The chart is also able to 
display the "value" and "ID" properties. 

Figure 26 shows a window display of the property sheet output from the 
Example 4 application. 

Processing Flow for Exposing Data 

20 Figure 27A and Figure 27B show a flow diagram of how information about a 

data item, e.g., a data item as shown in Figure 5, is exposed to data consumer 
components. In the preferred embodiment, data exposure within the system may be 
accomplished by one of three methods, described further below. There are two 
primary fiinctions to be performed: (1) interfacing with an internal or external data 

25 source such as a set of disk files, a database, or a web service; and (2) exposing the 
resulting data according to the standard interface outlined above, e.g., following the 
domain interface, relationships interface, and the like. 
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In the first method of exposure, one software component performs both 
functions; in the second method, separate software objects perform the two functions; 
in the third method, which is only implementable in an object oriented programming 
language that provides self-analysis facilities, such as Objective C or Java, the . 
5 exposure function is performed automatically by the system. More particularly, in the 
first method, a data source interface (DSI) software object is written that connects to 
an external data source such as a local file system, an Internet site, or an RDBMS. 
The DSI object converts the information provided by the external data source into the 
information representation or data item that may be consumed by data consumer 

10 objects as described above. In a preferred embodiment of the invention, the data 
source DSI objects are from the LeifDataltem class. 

In the second method, the API of an existing software data object is accessed 
by a Translator object, which then exposes the information to other data consumers in 
the representation format discussed above. This arrangement is referred to in the 

15 object oriented design literature as an Adapter or Wrapper pattern. See, for example, 
Gamma, E., Helm, EL, Johnson, R., Vlissides, J. (1995); Design Patterns: Elements of 
Reusable Object Oriented Software; New York: Addison-Wesley, This is generally 
referred to as ''wrapping". More precisely, a data consumer component requests 
information from the Translator object, which then converts the request into 

20 something the original data source object can deal with. The consumer then converts 
that object' s response into the appropriate format for a response to the original call. 

The third method applies the facilities within a self-analysis-capable 
programming language such as Java or Objective C. This type of programming 
language enables an object to determine the available data fields and function calls 

25 afforded by another object while an application is running. In the preferred 

embodiment implemented in Java, the queried object must be a "JavaBean" according 
to Sun Microsystem's suggested convention, with "getO" and "setO" method calls. 
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Each data field available through one of these calls, or by virtue of being a "public" 
variable, is examined, and the resulting type information is used to expose both the 
field's value and appropriate metadata to data consumers. If the field is a numeric 
type (double, Double, float, Float, Integer, int, long, ot byte in Java), it is exposed as a 
5 decimal or integer with an "unknown" unit of measure. If the field is a string (String 
in Java), it is exposed as a text element If the field is a complex object, it is exposed 
as a linked element via a reference (discussed above), unless a special class has 
registered to handle the complex object type within the application context or XIS 
framework. 

10 In another embodiment, in addition to the facilities for exposing data, the XIS 

framework provides an apparatus for allowing application context to affect how 
information is exposed This is illustrated in Figures 27A, 27B, and 28, described 
further below. The attributes, methods, and relationships available for a given data 
source are determined by a surrounding structure called an InfoModel. The 

15 InfoModel connects the pieces of the XIS framework together. It is an interface 

comprising an object that knows how to return data item information. See also Figure 
3A discussed above. 

In another preferred embodiment, an application comprises one or more Views, 
each containing and providing an InfoModel to one or more data consumers, termed 

20 INFOBEANS as described above, which may provide display, computational, or 
interactive facilities. All of the Views are in turn managed under a single ViewHost, 
which provides the global application context. Conceptually, a view represents a 
single perspective of the current data. One single perspective (or view) could be quite 
different from another because of the ability to add/override attributes in a view. 

25 View creates a new InfoModel that in turn creates new LeifDataltems that are used 
within that view. This is done to separate context sensitive attributes between an 
InfoModel and another View, INFOBEAN, or InfoModel. Views are also used as a 

69 



WO 02/46916 



PCT/US01/48418 



controller of one or more INFOBEANs by managing Che data flow to each individual 
INFOBEAN. All Views are also by definition INFOBEANs since they manage 
information flow with generic means. The YiewHost is used to manage the complete 
set of Views and INFOBEANs, thus presenting each view to the user in a uniform 

5 fashion such as frames, windows or other display mechanisms. 

Figure 27A and Figure 27B show a flow chart of a data exposure facility 
within the XIS framework constructed in accordance with the present invention. The 
diagrammed operations will occur when the XIS framework is loaded into program 
memory of a computer system that supports an object oriented programming (OOP) 

10 environment, as will be understood by those skilled in the art. In the first processing 
step, at block 2702, a data source object is registered within the XIS framework of the 
computer system. When a data item is brought into the framework, it is exposed to 
data consumer objects, e.g., via an InfoModel, typically via one of three methods. The 
first operation is to determine whether a Translator object is available and whether the 

is Translator object is registered for the raw data object type. This processing is 
represented by the decision block 2704. 

If the Translator is available, an affirmative outcome at the block 2704, then at 
block 2760 the data item attributes, methods, and Domains are obtained via the 
Translator. If the Translator is not available, a negative outcome at 2704, then at 

20 block 2706 the data item object is scanned to find the data object's methods. The 
scanning may be accomplished with facilities of the OOP environment of the host 
computer system, such as InfoBeans. 

After the data item object has been scanned at block 2706, the system next 
checks to see if the data item includes an XlS-standard data exposure interface (that 

25 is, a predefined interface known to the XIS framework). If the standard interface is 
available, an affirmative outcome at block 2714, then at block 2762 the data item 
object attributes, methods, and Domains are obtained from the data source object 
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itself. The system then checks for references to Domain Policies at block 2763. If 
there is no standard interface available at the decision block 2714, then processing 
moves to the block 2764, where the facilities of the programming language of the 
OOP environment are used to interrogate the data item object to determine the object's 

5 accessible data fields. Processing then moves to exposure attribute processing via the 
off-page connector B to Figure 27B, described below. 

Returning to block 2762, after the data item attributes, methods, and Domains 
are obtained, a check is made for Domain Policy references at the decision block 
2763. If there are references to Domain Policies, an affirmative outcome at the 

10 decision block, then at block 2765 a check is made to determine if there is 

FieldMetaData override for a Domain. If there are no Domain overrides, then at 
block 2710 the definitions from the referenced Domain Policy are used for the 
attribute metadata. The processing then moves to exposure attribute processing via 
the off-page connector A. If there are Domain overrides, an affirmative outcome at 

1 5 block 2765 , then at block 27 1 6 the system uses the definitions included with the data 
item object Translator for the attribute metadata of the data item. The processing then 
moves to exposure attribute processing via the oflF-page connector A. Referring back 
to block 2763, if there were no references to Domain Policies, then processing 
proceeds straight to block 2716 to obtain the attribute metadata definitions and then to 

20 the exposure attribute processing via the off-page connector A to Figure 27B. 

Turning to the processing of Figure 27B via the off-page connector A, the data 
item attributes are exposed to the local InfoModel class (i.e., a DST object). Next, at 
the decision block 2770, a check is made to determine if the data item has any 
dynamic attributes. If the data item does, then at block 2772 the framework 

15 processing adds the dynamic attributes to the available data item attributes. If the data 
item has no dynamic attributes, or after any dynamic attributes have been added, 
processing moves to block 2773, where the system checks to determine if a Translator 



71 



VilO 02/46916 



PCT/US01/48418 



was provided (registered) for the Data Source object If a Translator was provided, 
then at the decision box 2775 the system checks to determine if reflection has been 
requested Those skilled in the art will understand that reflection is an operation that 
is provided by most OOP environments, such as by Java. 
5 If reflection is to be performed, then processing returns to Figure 27A via the 

off-page connector C, whereupon the Data Source is scanned. If reflection is not to 
be performed, or if no Translator was registered (a negative outcome at block 2773), 
then processing moves to the decision block 2774, At block 2774, the system checks 
to determine if the data item has registered any e>ctended Translators. If there are no 

10 extended Translators, then at block 27 1 8 the data item attributes are derived, added, or 
hidden, depending on the data context gleaned from the DSL The data item is then 
fully exposed to data consumer components for use (block 2790). If there are 
extended Translators, an affirmative outcome at block 2774, then processing returns 
to Figure 27A via the off-page connector B to obtain the information from such 

15 Translators (block 2760). 

Figure 28 is a diagram showing how InfoModels provide contextualization 
within the XIS framework. The initial "raw" object (e.g., Java object or data from 
RDBMS) provided by the data source is exposed through mediation by successive 
"wrapping layers" of other objects, which determine which fields are visible, and 

20 possibly performs conversions or consolidations. Each "View" within the XIS 

framework, which contains one or more "INFOBEAN" consumers, carries with it its 
own context Feeding a data source component to a consumer component places it 
within that context. 

When a data element provided by a data source is introduced to an InfoModel, 
25 the InfoModel actually provides a new element derived from this one to consumers. 
This derived element provides the actual data source interface discussed above. The 
attributes, type metadata, and methods provided for the element are first determined 
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as described below under "data exposure facilities". Then the InfoModel inspects the 
results and decides whether to add or derive any new attributes, or to hide existing 
attributes. Once the data is added to an InfoModel (discussed below), it may be asked 
for by other components for processing and visualization purposes. 
5 In another embodiment, the ViewHost, a data consumer component, provides 

facilities allowing interactive cut and paste and drag and drop of information elements 
between different consumer components* When a cut-and-paste or drag-sand-drop 
occurs, each information element is decontextualized and then recontextualized inside 
the new InfoModel into which it is placed This means that some attributes 

10 previously available may be removed, whereas others, more appropriate to the 
functions of the recipient consumers), may be added. 

Referring back to Figure 28, this figure shows how multiple InfoModels work 
to share references to raw objects. This figure also illustrates how an INFOBEAN 
and/or a DSI adds objects to the InfoModel to obtain data items. The DSI 2815 

15 creates an instance of source raw data item (e.g., Java object) 2830. The original 

source objects are maintained by DSI and one or more InfoModels have references to 
these source objects. The raw data item 2830 is provided to or may be used by an 
INFOBEAN (data consumer) via the addRawDataItem() method. (Please refer to 
Table III above. The second line of code shows that the source object is added to the 

20 TablelnfoClass.) 

The INFOBEAN 2820 requests the data item for the raw object 2835 (which 
was the source object 2830) from its InfoModel or the BaselnfoModel. The 
BaselnfoModel as discussed above is responsible for creating and caching every data 
item (wrapping any object). Each InfoModel is considered to contain a subset of data 

25 items from the entire set of data. The InfoModel is a view of the BaselnfoModel, 
thus, there may be data items in the BaselnfoModel that are not present in the 
InfoModel used by the INFOBEAN. The circles 2828 shown in the InfoModel 2805 
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represent attributes, domains, relationships, etc. from the BaselnfoModel. For 
example, Figure 6 contains a list of information that an INFOBEAN may obtain about 
the Person object, in this case 2830, 2835, through the LeifDataltem API. In addition 
information from nested InfoModels arc inherited. An InfoModel 2805 also always 

5 adds new items to the BaselnfoModel, e.g., common attributes such as "selection" are 
delegated These new items are also exposed to the INFOBEAN as shown by the 
number of circles in 2840. 

The BaselnfoModel 2810 returns the raw data object 2845 to the InfoModel. 
The InfoModel 2805 returns a data item 2 840, which exposes the information, for 

10 . example, shown in Figures 4 and 5 to the INFOBEAN 2820. A data item 2845 (see 
Figure 4) is returned, which may have been created or may have already existed in the 
InfoModel. 

In the XIS framework, as shown in the InfoModel, attribute and method 
"requests" mechanisms are available. Standard mechanism to retrieve the current 
1 5 value of any Attribute, or set the current value;, if the Attribute is mutable, may also be 
, easily implemented. In one embodiment^ this mechanism also enables a standard 
syntax and mechanism for the invocation of any domain method. 

These attribute and method "request" objects contain all of the information 
necessary for the data source to fulfill the requested task. It contains the actual 
20 ("raw") data item whose attribute value is being sought or set (along with the desired 
new value), or whose domain method is being invoked. They also contain contextual 
• information, such as the current User, allowing data source developers to implement 
foil user-based information access and security controls, and a context for obtaining 
services (implemented through the Java "BeanContext" APIs). This is significant 
25 because it enables the process of executing methods and/or getting or setting values to 
leverage services "in context" such as the current data view (or window) through 
which to interact with the user. These request objects also contain contextual "data 



74 



WO 02/46916 



PCT/US01M8418 



item" (e.g., LeifDataltem), as opposed to the "raw" non-contextual data item, from 
which to get additional or overridden values or execute additional/overridden 
methods, if appropriate to the task. In another embodiment, these "Request" objects 
are not only passed when getting/setting values, or executing domain methods, but arc 
also passed to all other 'Translator" methods that take and may need to access or 
manipulate the data item. The "Request" object not only provides context, hut also 
ensures tihat the DSI (via the Translator) always has what it needs (particularly, the 
User information) to manage its security constraints, if any. 

A data item locking mechanism for obtaining, holding, and releasing a lock on 
an individual data item may be implemented in accordance with the present invention. 
This implementation is best defined by the data source provider, by implementing 
such locking mechanism in the data source, itself. Ad hoc implementations for data 
sources that do not provide native locking may also be done via the DSIs. This 
mechanism enables DSIs to implement multiple changes atomically (as one 
transaction) by effecting those changes at the time of the release. In addition, a 
"rollbadk" feature for atomic changes is possible through the "revert" capability, 
which generally releases the lock without affecting the previous changes. This 
locking mechanism may also be leveraged to lock multiple objects simultaneously, at 
the discretion of the DST, by associating the lock with a DSI-defined 'lock object" 
which can either be associated with a single data item or with a group of data items, as 
appropriate. Using the DSI API, this provides to data consumers a single API for 
dealing with locking implementations. 

Figure 29 shows an embodiment of a "plug-in manager" called PluglnManager 
of the present invention. The programming framework embodied in this invention 
includes a ft plug-in manager" which provides extensible communication between 
services and components within an application. Plug-ins are software modules that 
add a specific feature or service to a larger system (i.e., plug into a larger application 
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to provide functionality). For example, there are a number of plug-ins for the 
NETSCAPE NAVIGATOR browser that enables the browser to display different 
types of audio or video messages, e.g., SHOCKWAVE by MACROMEDIA. 

A "service" is capable of obtaining information on a data consumer or data 
5 source component and capable of using that information to provide specific facilities 
to the application as a whole. Examples of such facilities include addition of entries 
to a top level application menu, loading MIME types into the global MIME type map, 
and running of scripts upon loading or unloading of data sources or consumers. The 
plug in manager loads new services at initialization and also at any time through an 
10 explicit request. The service in turn queries all modules present in the application as 
to whether they request any actions of the given service, executing them if so 
indicated. 

In more detail, as each new module, object, or component is loaded into the 
XIS framework, the PluglnManager 2905 on startup loads a special service called 

15 PluggableServiceFinder 2925, which searches for other services 291 5 and loads the 
services found into the PluglnManager 2920. The PluglnManager holds or keeps 
track of all services, These services are referred to as PiuggableServices. As each 
pluggable service is loaded, the PluglnManager searches such service for defined 
resources and attaches these resources to the appropriate components or performs 

20 . actions on resources found 2935. For example, a menu manager service might search 
. for resources specifying menu entries and associated operations. A component that 
wants to add a menu entry to the global application menu bar would simply provide a 
resource of this type. In essence, as each new module is loaded, the PluglnManager 
tells the currently registered services (''PluggableServices") to look for new plug-ins. 

25 Thus, in essence the PluglnManager acts as a plug-in for plug-in handlers. 

The combination of the PluglnManager and the PluggableService interface 
allows communication between an XIS application and various XIS components. The 
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components may contain a number of resources that affect certain areas of X1S. For 
example, they may have a resource file that contains an ECMA script. ECMA is an 
international industry association dedicated to the standardization of information and 
communication systems (see www.ecma.cb). If there is a PluggableSeivice that 

5 knows about that resource file, then it may decide to run the ECMA script when it 
finds the resource. The PluglnManager is responsible for managing the resource list 
and all PluggableServices. When a new PluggableService is added, it is given all the 
resources to determine if it is interested in any of the resources on the list If it is 
interested in a resource, then it may perform some action. 

10 In one embodiment of the invention, an ASCII file is created to indicate that a 

JAR file contains a resource to be provided to all PluggableServices. 

Table IX below shows an exemplary ASCII file that indicates that there are 
resources associated with the module containing the TableView class. It does not 
indicate what resources exist; it is up to the PluggableServices to determine if there is 

15 a resource in which they are interested. The PluglnManager, using Class.forName(), 
creates the Table View.class and calls the loadPlugln method on each of the 
PluggableServices. Below is the content of the loadPlugln method in the 
MimeTypesPluggableService: 



Table IX 

public static final String RESOURCEJNAME = 'leifResources/raime.types"; 
public void loadPhigIn(Class relativeClass) { 
if (loadedResources = null) { 
synchronized (this) { 
if (loadedResources = null) { 

loadedResources = new HashSetQ; 
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} 

} 

} 

try{ 

String resource « PlugInManager.convertResourceName( 

relativeCIass, RESOURCE_NAME); 
ClassLoader loader = relativeClass.getClassLoaderO; 
Enumeration enum = loader.getResources(resource); 

while (enumJiasMoreElementsO) { 

URL resourceURL = (URL) enum .nextElementO ; 
if (resouiceURL H null) { 

if (!loadedResources,coDtains(resourceURL)) { 
loadedResources.add(resourceURL); 
LedDAFUtilities.addMimeTypes( 

baselnfoModeLgetOwnedBeanContextChildQ, resourceURL); 
} 

} 

} 

} catch (IOException e) { 
aprintStackTraceO; 

} 



The entire arrangement of data sources separated from consumers by a 
mediating structure, InfoModels providing context to Views, and a ViewHost and 
5 plug in manager playing set central organizing roles, allows a multi-purpose 
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application to be rapidly assembled out of preexisting components. Each available 
data source and consumer component may be integrated into the application by the 
plug in manager, and compartmentalization. 

Figure 30 shows a flow diagram of an embodiment of the invention that assists 
5 in creating XML (extensible markup language) DSIs and database DSIs, The XIS 
framework provides two sets of facilities for exposing electronically available 
1 information that comes from data sources that are partly structured and/or self- 
describing, and for writing back possibly modified information to the sources. For 
example, one of these works for XML formatted data, and the other works for data 

10 stored in relational databases. However, the mechanisms are inherently extensible to 
any other data source that is partly structured and/or self-describing. 

The World Wide Web Consortium (W3C), which has standardized most of the 
XML formats to date, is in the process of defining a new XML format for declaring 
schemas, called XML Schema. The XML schema addresses the means for defining 

15 the structure, content, and semantics of XML documents. The present invention is 
configured to take into account future versions of the XML schema. 

In one embodiment, the present invention includes aspects of the method 
outlined below that are in common between the XML and relational database 
interfaces and can be applied in this general capacity to be part of the invention as 

20 well. In particular (described further below), an embodiment includes the apparatus 
involving separate processing of "data" (3002 branch) and "schema" (3004 branch) 
information, with a type conversion stage 3012 during the former and a metadata 
creation stage 3014 during the latter, followed by the construction of semantically 
enriched attributes 3016, 3018 based on the results of both these processes. 

25 In one embodiment, one method involves two apparatus or facilities designed 

to handle extensible markup language (XML) formatted data. An XML text stream 
comprises of a set of hierarchically structured "tags" interspersed with text "content". 
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The names, data types, and ordering of the tags may vary from stream to stream and is 
specified by a separate document called an "XML schema" A description of the 
XML schema is provided in the document "XML Schema Part I: Structures (Working 
Draft)", which may be obtained from the W3C at the WWW address of 
http://www.w3.org/TR/xmIschema-l, and also in the document "XML Schema Part 2: 
Datatypes (Working Draft)", which may be obtained at the WWW address of 
http://www.w3.org/TR/xmlsdiema-2. Given an XML data stream, the first apparatus 
parses the XML schema appropriate for it and constructs metadata specifications 
appropriate for the contents of each tag. In some cases, these specifications are in the 
form of computer program segments that can be compiled into executable procedures 
that can be accessed immediately by a running application; in other cases, they refer 
directly to already precompiled procedures. The second apparatus parses the data 
document, matching the tags up with the types and metadata derived from the schema, 
and exposes the content in the standardized infoimation representation using this 
metadata. This information includes the generic relational links described above in 
addition to attributes and metadata. 

In particular, the structures defined by an XML schema document determine 
the hierarchical and type structure allowed in XML instance documents, and this 
structure is paralleled again in the information elements (with attributes and member 
elements) constructed on parsing an instance. The following table (Table X) shows 
the correspondence: 
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Table X 


XML Schema 


Compliant XML 
Instance 


Resulting Information 
Element 


simple type outside attribute 
declaration 


element with no 
subelements 


(typed) attribute 


simple type inside attribute 
declaration 


attribute 


(typed) attribute 


complex type without 
descendents 


element with attributes 
but no subelements 


information element with 
attributes 


complex type with 
descendents 


element with 
subelements 


information element with 
member elements 



A complexType element, as defined in the W3C XML Schema standard, 
defines the structure of an information element. Elements contained within the 

5 complexType element which are defined as complexTypes themselves, are translated 
into the member elements of the information element defined by the containing 
complexType. All other elements and attributes contained within the complexType 
element, and defining single value types, are translated into attributes of the 
information element defined by the containing complexType. 

10 The XML ingestion process supports an additional capability that allows for 

the translation of types defined by an XML Schema, into more semantically rich 
domain policy based attributes that consumers in the present framework can take 
advantage of. To do this an embodiment of the present invention includes a process 
that uses XSLT (XML Stylesheet Language Transformations) to scan an XSDL 

15 (XML Schema Definition Language) document, and embed domain specific 

instructions in a new version of the XSDL document The embedded instructions 
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direct the XML processing software to create information elements that contain the 
semantically richer domain attribute representations. In particular, the tags in the 
table below may be placed by the XSLT within <appinfo> subelements of elements in 
the XSDL schema document. When the schema parsing apparatus reads the resulting 
schema > it sets up the XML processor to perform the mappings as shown when 
reading an instance document. Because of the nature of the handling specified for 
<appinfc£> elements in the XSDL specification (see the W3C Web site at 
http://www.w3.org/5QVIL/Schema), these will simply be ignored by other XML 
schema processors that have not been designed to read them. Table XI lists properties 
that may be used: 



Table XI 


Property 


Description 


domainfield 


A Domain Policy attribute to map instances of this XML element 
or attribute to 


typemetadata 


A metadata type to map instances of this XML element or 
attribute 


converter 


A type converter for transformation of XML data values (strings) 
into typed values such as floating point numbers or date objects 


visible 


The initial visibility state with which instances of this XML 
element or attribute should he exposed within an information 
element 


mutable 


Whether or not instances of this XML element or attribute can be 
edited after being exposed within an information element 
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Conversely, the system has the ability to construct an XML document and 
associated XML Schema from a hierarchy of information elements. The process for 
outputting an XML document and associated XML Schema from a hierarchy of 
information elements is essentially the reverse of the ingestion process. The resulting 
5 schema documents are generated with the special <appinfo> instructions that cany the 
additional semantic meaning for the attributes, but (see above) these additional 
instructions are embedded in a way that makes them transparent to other XML 
document readers that do not recognize them. In this way, an application-to- 
application information communication session can be set up using HTTP or a similar 

10 protocol for synchronous communications, and SMTP or similar for asynchronous 
communications. The sending application encodes information elements into an 
XML schema/instance pair using the just described apparatus and sends both to the 
receiver application. The receiver reconstructs the information elements also using 
the above apparatus. Thus, any form of structured, annotated information that can be 

1 5 expressed within our framework can be transmitted between applications using a 
simple document transfer protocol Another embodiment of the present invention 
involves an apparatus 3020 , which will connect to a relational database system and 
extract or write information from it using the structured query language (SQL). The 
user of such an information source needs only to specify the tables and columns to 

20 access within the database, as well as any selection criteria to narrow the range of data 
returned. The apparatus performing this function will automatically convert the data 
in the database into the appropriate representational format and add metadata and 
parent-child links as required. In general, the process is similar to that described for 
the XML data input/output capability, except that SQL statements and conversion 

25 mappings specified by the user take the place of the XML schema and document type 
and hierarchy information. 
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The process translates the result of a database query into an XIS data item, and 
each row in the result set is translated into a member data item of the result data item. 
Each row data item can also have a database quay associated with it which can be 
executed to provide its own member data item. Access to the member items is on- 

5 demand (e.g., as called for by a consumer), an operation we refer to as "drill-down". 
The row data items are created with attributes that are derived from the 
columns returned by the result set. The attribute specifications can be generated 
automatically from the result set column SQL type specifications (integer, date, text, 
etc.), or can be customized to suit the needs of the user. The customization process 

10 allows the user to map database result column type definitions into more semantically 
rich domain policy and/oT metadata-enhanced attributes that consumers can take 
advantage of. In other words, the DSI can associate column data types with metadata 
types and domain policy attribute types. To do this the framework supports a number 
of attribute customization properties that the user can specify (described further 

15 below). 

Modifications to row data items are handled by allowing the user to associate 
parameterized update, insert and delete queries with a given result set When the 
value of a record member attribute is changed, the user specified parameterized query 
is executed, and the parameters are filled m from the attribute values identified in the 
20 query specification. Insertion and deletion of record members are handled in a 
likewise manner. 

The following table, Table XII, describes the list of customizable properties 
supported by the SQL database interface process. These properties are used to 
describe a single interface to a database for producing one or more hierarchically 
25 organized information elements from its contents. 



84 



WO 02/46916 



PCT/US01/48418 



Table XII 


Property 


Description 


jdbc.driver 


JDBC vendor driver class name 


jdbc.url 


JDBC database connection URL 


display .name 


Default display name for result data item 


selectquery 


SQL select statement for result data item 


update.query 


Parameterized SQL update statement 


update, columns 


Result column names that fill update query parameters 


insertquery 


Parameterized SQL insert statement 


tnsertcolumns 


Result column names that fill insert query parameters 


delete.queiy 


Parameterized SQL delete statement 


delete.columns 


Result column names that fill delete query parameters 


drilldown. query 


Parameterized SQL select statement for record drill- 
down 


drilldown.columns 


Result column names that fill drill-down query 
parameters 


resultattributes 


Result data item attribute names 


record.attributes 


Record data item attribute names 



The names of attributes listed for both result and record data items are used to 
uniquely identify the attributes. The customization of each attribute is done according 
5 to its unique name. The following table (Table XIII) describes the list of 

customizable properties that can be applied to each attribute, where <name> is the 
unique attribute name. Note the parallel between these properties and those given for 
the ! <appinfo>' tag insertion in the case above of XML data parsing. 
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Table XHI 


Property 


Description 


<3iame>.label 


The attribute display label 


<name>.domainfield 


A XIS Domain Policy class field to map this attribute 
to 


<name>,typemetadata 


A XIS metadata class name to map this attribute to 


<name>.converter 


A XIS type converter for transformation of result 
values 


<name>.columns 


The result columns names that will be converted 


<name>.visible 


The attribute initial visibility state 


<name>.mutable 


The editability of the attribute 



Given the metadata from known industry standard APIs (e.g., JDBC and 
ODBC) that provide metadata for results (typically handled as tabular columns) 

5 including string, length, numeric precision, date formatting, etc, relational databases 
may have dynamic DSI toolkit built and implemented as shown in Figure 27. Tabular 
data may also be interpreted as a default string typed Java objects, remote Java 
objects (via RMI or CORBA-derived interfaces), and Enterprise JavaBeans (a variant 
of RMI objects) may have DSIs automatically created for them, using, for example, 

10 reflection and known types (primitives and other typical types like String, Data, etc., 
and registered types). A developer may also place XlS-specific annotations (e.g., 
static AttributeDescriptor and FieldData methods) on reflected Java objects. 
Collection subclassed objects may also indicate containment. 

Dynamic data supplemental metadata may also be used in the XIS framework 

15 of the present invention. Scheraas with little or no expressive information may also 
be used to specify additional metadata within the XIS framework, which include 
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mapping attributes to type metadata, mapping attributes or methods to domains, 
defining new attributes/methods based on existing data from the source, defining 
functions/user commands for easily implemented capabilities (e.g., deleting a data 
item, adding/inserting a new data item, initializing a template data item that a user can 
s fill in before adding, etc.), and defining relationships to other data items to perform 
"drill-down" queries. Such type of schemas may be obtained, for example for Java 
Metadata API, CORB A API (on which the Java API was based), Oracle "common 
warehouse metamodel," and the like. Other formats for mapping metadata to schemas 
from other sources, or as might be defined in the foture, may easily be incorporated 
10 within the framework. 

Distributed Application Capabilities 

In an embodiment, the application development framework being discussed 
offers three sets of facilities to aid in the development of distributed applications in 
which users, software application components, or both are distributed across multiple 
1 5 computers connected by a network. 

CORBA Exposure 

The first set of facilities allows the automatic exposure of a data source over a 
network to any remote consumer software object via the Common Object Request 
Broker Architecture (CORBA) protocol. This protocol allows the remote consumer to 
20 utilize information elements just as if they existed locally, but usually with lower 

bandwidth than it would take to send the entire elements over the network connection. 

To better understand the invention, examples are shown below in Table XIV, 
which shows an exemplary XML document. 



Table XIV • 


<tracks> 




<track name="FIRST"> 
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<country>US</country> 
<category>SUB<category> 
<threat>HOS</threat> 
<position> 

<lat>10.0</lat> 
<on>10.0</lon> 
<alt>10.0</a]r> 
</position> 
<track> 

<track name^'SECOND'^ 
<country>US</country> 
<categoiy>AIR</categoiy> 
<threat>FRI</threat> 
<position> 

<lat>20.0</lat> 
<lon>20.0<Aon> 
<alt>20.0</alt> 
</position> 
</track> 
</tacks> 



The following table (Table XV) shows the result if fhp above XML document 
were run through an XML DSL 

5 

Table XV 

LEIF Data Item - tracks 
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LEIF Data Item - track 

Attribute - name : String value^FIRST 
Attribute - country : String value= , US' 
Attribute - category : String value='SUB' 
Attribute - threat : String value^'HOS' 
LED? Data Item - position : LEIF Data Item 
Attribute - lat : String value='10.0' 
Attribute - Ion : String value-' 10.0' 
Attribute - alt ; String value-' 10.0' 
LEIF Data Item - track 

Attribute - name : String value-SECOND' 
Attribute - country : String value-TJS' 
Attribute - category : String value^'AIR' 
Attribute - threat : String value=TRT 
LEIF Data Item - position 

Attribute - lat : String value-^O.O* 
Attribute - Ion : String value-'20.0 > 
Attribute - alt : String vahie-^O.O* 



Table XVI below shows an exemplary XSDL document. 



Table XVI 

<?xml version="L0" encoding="UTF-8"?> 
<schema xrnlns="http://ww.w3.org/1999/XMLSchema n ^ 
<element narne="tracks"> 
<complexType> 

<element name="track n type-Track" maxOccurs= ,l unbounded7> 
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— " </complexType> 
</element> 

<complexType nameF= M Track f, > 

<attribute name= ,l name ,f type~"string7> 
<Blementname= !, coiintry w type= M 5tring n /> 
<elementname="category" type-'string^ 
<element nameF="threat M type= rf string'7> 
<elementnameF= n position" type= rr LatLonAlt ,, /> 

</complexType> 

<complexType name="LatLonAlt"> 
<elcment name= ,f lat" type-"deciinar7> 
<element name^'lon" type=MedmaT/> 
<element name="alt w type= s,, decimal n > 

</complexType> 
</schema> 



XML Schema Definition Language (.xsd) documents are used to express the 
semantic descriptions of Attributes and the Domains in which they live. Code 

5 generation utilities as described above create the actual Domain Objects with their 
groups of related Attributes. Thus, developers may create new Domains, and add 
Attributes to their existing Domains, by modifying these XML Schema files and 
generating the appropriate Java code. XML Schema files include basic attribute 
constraints (e.g., value ranges, list of valid values, attribute naming, formatting, etc.) 

10 that are turned into TypeMetaData objects, as well as textual comments that are 

converted into Java documentation to define the intent of the attribute (or method, in 
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the case of Domain methods). In some cases, Java code is embedded in the document 
and used inline in the generated Java classes for the Domain. 

Table XVTI below shows the result when the above XSDL document is used to 
type the elements in the XML document source. Note that the type for lat, Ion, and alt 
5 are now Double instead of String. 



Table XVH 

LED? Data Item - tracks 
LEIF Data Item - track 

Attribute - name : String value= , FIRST > 
Attribute - country : String value^US' 
Attribute - category : String value='SUB > 
Attribute - threat : String value^'HOS' 
LEIF Data Item - position 

Attribute - lat : Double value=' lO.O* 
Attribute - Ion : Double value='10.0' 
Attribute - ah : Double valued 10.0' 
LEIF Data Item - track 

Attribute -name : String valued SECOND' 
Attribute - country : String yalue^'US' 
Attribute - category : String value^ AIR' 
Attribute - threat : String value=TRT 
LEIF Data Item - position 

Attribute - lat : Double value='20.0' 
Attribute - Ion : Double value='20.0' 
Attribute - alt : Double value^'20.0' 
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The following table (Table XVIII) shows an exemplary XSLT document. 



Table XVm 

<xsl:for-each select="xsd:element ,, > 
<xsl:choose> 

<xsl:when test= M @name= l position ,ff > 
<xsl:copy> 

<xsl:apply-templates select=="@*7> 
<annotation> 
<appinfo> 
<domainmap 

domainfield- !l com.xis.dom^ 
converte^TJegreesToLatLonAltConvBrter' 1 
parameters- lat,lon,alt" 
labcKTosition" 

/> 

</appinfo> 
</annotation> 
</xsl:copy> 
</xsl:when> 
<xsl: otherwise> 
<xsl:copy> 

<xsl:apply-teniplates select^" @*'7> 
<yxsl:copy> 
</xsl:otherwise> 
</xsl:choose> 
</xsl:for-each> 
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When such a transformation is used with the previous XSDL source shown 
above, used to type the XML document source, the result is shown in Table XDC 
below. 



Table XIX 
LEIF Data Item - tracks — — — — 
LEIF Data Item -track 

Attribute - name : String value^FTRST* 
Attribute - country : String value= , US > 
Attribute - category : String value='SUB' 
Attribute - threat : String value^'HOS* 
Attribute - position : LatLonAlt <- now mapped to 
GeoDomain.latLonAlt 
LEIF Data Item -track 

Attribute - name : attribute value= , SECOND > 
Attribute - country : String value= 9 US' 
Attribute - category : String value=' AIR* 
Attribute - threat : String vaIue='FRF 
Attribute - position : LatLonAlt <- now mapped to 
GeoDomain.latLonAlt 



Note that position has been mapped to GeoDomain.latLonAlt, meaning, it is 
now a LatLonAlt type. The lat, Ion, and alt attributes are still the same, but the 
position itself may now be dealt as a single LatLonAlt object rather than a generic 
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data item with three Double fields. The use of XSLT also enables the mapping of 
XML elements into TypeMetaData, such as the LatLonAltTypeMetaData in order 
have better manipulation of the data. 

In one embodiment of the invention, the XIS framework has a "remote" 
capability enabling referral to an XIS session, or the data within it, from a remote 
virtual machine. Primarily, this means that data retrieval and sharing is the basis for 
export and collaboration. Secondarily, it supports operating on data within XIS from 
a remote virtual machine, perhaps on information existing only at that remote virtual 
machine. 

In another embodiment, SOAP (Simple Object Access Protocol) may be 
utilized. SOAP is a messaging framework that defines a protocol for the exchange of 
information in a decentralized, distributed environment See, foT example, the W3C 
Web site at http://ww.w3.oi^TR/SOAP. SOAP provides an instantiation of the 
remote capability, and is used to enable a general-purpose means of mating together 
or communicating among distributed sessions. These sessions may be two full XIS 
sessions on separate servers, or may comprise one XIS server and one XIS client, or 
may be used to interface XIS to otherwise very different software, even including 
software applications written in different programming languages and running on 
incompatible operating systems. All data and remote procedure calls are made 
through XML. Those skilled in the art will be understand that SOAP is an XML- 
based protocol. The working draft of this specification is currently being developed 
bytheW3C. 

In another embodiment, remote references are used. These references are 
persistable or persistent references to XIS data. In a distributed context XIS uses 
XML representations of the references to share, persist, or identify particular data. 
Embedded in the XML are custom information enabling determination of data 
location in files or databases, on web servers, or based on unique Ids or names within 
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the XIS session, or based on data which are passed to a constructor, or on an ECMA 
script that can re-generate the data object. 

In another embodiment, the data representation in the remote distributed 
sessions is all based on the XIS mediation layer. All data, regardless of the initial 

5 type, is passed and manipulated as sets of attributes and relationships. This greatly 
enhances portability and interoperability of the data. At the same time the data 
contains a global unique identifier, so the individual and specific source and identity 
of that data is maintained in spite of having been translated to a mediated format. 
In another embodiment, a metadata type* e.g., "Constructor Scripts," is used. 

10 This metadata type supports the generation of ECMA Script scripts to restore a 
TypeMetaData (metadata type) object at a later time. By executing the script, the 
TypeMetaData is restored to its exact state. The advantage over standard Java object 
serialization is control over the save/restore process, and the ability to represent the 
state in fairly readable text format. 

is Distributed Multi-user Collaboration 

Figure 31 is a schematic diagram of the second set of facilities that allows 
users at remote computers to collaborate through shared views of the same data. It 
also shows objects and methods that may be involved in distributed collaboration 
facilities. Visual consumer components (e.g., INFOBEANs) are condensed and 

20 compressed so that they may be efficiently accessed by a remote computer and then 
locally displayed. This is done using a MetaView object, which encapsulates the 
essential elements of a visual component to allow reconstruction on another screen 
with minimum requirement for data transmission. MetaViews are manipulated using 
the relationship handling machinery of the framework as discussed above; in 

25 particular, an indirect reference to the MetaView is produced and passed around to 
remote consumers, who need only resolve the reference and retrieve the MetaView 
object if the user requests the display. 
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An event-handling schema is introduced for transmission of changes in the 
view from one computer to all others that are joined to the session. View 
management is accomplished via a "tree" display showing hierarchies of local views, 
sessions, and shared views (including properties and subsidiary data items). Views 
5 may be shared through the intuitive action of dragging and dropping them from one 
branch on the tree to another. Multicast protocols may be used so that MetaViews, 
LeifReferences (references), and Event objects may be transmitted directly from one 
computer to another without the need to go through a server. Alternatively, HTTP 
protocols may be employed if security and firewall considerations make multicasting 
10 impractical. 

Metadata Server Facilities 

Figure 32 shows a third set of facilities that allows remote consumer software 
objects 3220 to obtain additional annotations on information that is encountered along 
with at least a minimal self-description component, as may be found, e.g., in an XML 

15 tag name. These facilities are targeted to be useful to software agents 3202 in 

particular. (See Wooldridge, M., Jennings, N. (1995); "Intelligent Agents: Theory 
and Practice 11 in Knowledge Engineering Review 1 0:2.) For example, a Java software 
agent may occasionally encounter data objects or request terms, which were not 
anticipated when the agent was programmed. The tag name or other descriptive 

20 annotation (connector) 3206 is used as a key to request metadata and possibly domain 
policy methods defined within XIS from a known server, called a semantic repository 
3204. The server 3204 checks its index for a match; if a match is not found, it can 
optionally ask a predicate logic inference engine 3208 to provide alternate names to 
search under (e.g., "cat, large, ferocious" is returned from the inference engine in 

25 response to a request for 'lion"), which are then also compared to the index. If a 
match is found, the server returns the appropriate metadata and possibly domain 
policy rnethod(s) to the requesting agent 3202, making use of either Sun's Jini 
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framework or Java's built-in provisions 3222 for network transfer and subsequent 
dynamic loading of classes (including, e.g., procedural components of the metadata 
and methods) to transfer the actual code procedures into the running agent. These 
transferred infonnation can then be used by the agent 3202 to aid in handling the 
5 object. For example, an agent can display an unanticipated data type to a user by 
calling the renderer method thus returned from the semantic repository. The semantic 
repository may also interface with other repositories 3212 via a data network 3210, 
such as a wide area network (WAN) 32 10. 

In the above embodiment, infonnation metadata and even information access 
10 software may be dynamically downloaded from remote sources ("semantic 

repositories' 1 or "Metadata Server Facilities"), e.g., from the data source itself or from 
an intermediary server. This is a unique feature particularly as applied to XIS 
metadata, domain policies, and DSIs. 

One skilled in the art will further understand that the common representation of 
15 and access to information from internal APIs (mediation layer) may be exported to 
distributed application in support of middleware architectures for scalability or other 
advantages, and in support of collaboration by sharing data and data changes 
(permanent or transient) with other distributed collaborators. 

The present invention also supports user "transfer" of objects from one context 
20 (e.g., between two INFOBEANs) via drag/drop, cut/paste, and other mechanisms. 
Transfers of objects apply only to non-contextual infonnation. Thus, each view has 
its own InfoModel that provides the contextual information for that view alone. 
Example 5 below further explains this idea. 

Example 5 

25 The Example 5 application is contained in three Java source files, 

HelloWorldjava, HelloWorldTranslatorjava, and TestHarness.java. The source files 
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for this Example are explained below. The resulting outputs are shown in Figures 
38A and 38B. Non-contextual information is transferred in this Example. 

The Java source files in Example 5 modify those from Example 3 or 4 to 
demonstrate the use of drag and drop facilities within XIS, along with a more 
complex view. As before, changes from the previous step are marked by open and 
close commented braces. 

The table below (Table XX) shows a code snippet that replaces a portion of 
code in the Hello Worldjava file shown in Example 3. The code portion below 
replaces the portion of code 2102 found m Figure 21 to implement Example 5. 



Table XX 

/*{*/ 

private String myName; 
public HelloWorld(String myName) { 
this.myName = myName; 

} 

public String toStringO { 
return myName; 

} 



With the above modification, the HelloWorlAjava file for this Example has 
been enhanced so that instances can be given names upon creation, and this name is 
returned by the toStringQ method. Also, the getTDQ method has been removed. 
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The HelloWoiidTranslatcw: Java file for this Example is similar to the 
HelloWoridTranslator.java file shown in Figures 22A to 22C, except that this source 
file has been simplified from the previous version by removing the "course" attribute. 
Figures 37A to 37D list the TestHarness.java source file, where the bulk of the 
5 changes are coded. First of all, it contains an import to help lay out multiple 

components within a Jframe 3702, and also imports for two new XIS INFOBEANs: a 
Table bean and a Tree bean 3704. The tree bean displays data items and any member 
data items they contain, and enables users to select and perform various functions on 
4 them such as editing their properties. The table bean displays the attributes of 
10 multiple data items in a user-configurable way. 

The first portion of new code 3706A and 3706B initializes several HelloWorld 
objects and inserts them into an array. Hie table and plot INFOBEANs are initialized 
and placed side-by-side in a JFrame. They are not loaded with any data items, but 
items can be dragged onto them when the application is running. The next thing is 
15 that a tree INFOBEAN is initialized and loaded with the array, and it is put up in its 
own JFrame. 

This Example 5 application puts up two windows-the first is a Tree 
INFOBEAN containing several HelloWorld data items. The second has two frames, 
on the left a Table INFOBEAN, on the right a Chart INFOBEAN, both of which are 

20 initially empty. The table is initially completely blank because it has no information 
on what headings are appropriate, while the plot displays a default grid. 

In the tree display, a user may select data items or open and close them, similar 
to the directory tree view provided by the "Windows Explorer" application. In tins 
case, the only item that contains anything is the root, which is a special data item. 

25 Double-clicking on it opens or closes it, but it cannot itself be selected. Right clicking 
on an item (but not the root) brings up a menu of operations that may be performed on 
it In particular, selecting 'Properties 1 brings up a property sheet, window (as in the 
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previous examples) for that particular instance. A user may left-click-and-drag on 
data items from the property sheet window over to tbe table or the plot 

The table automatically sets up columns for the preferred attributes of the data 
items dragged onto it. The layout may be changed interactively by either dragging on 
the headings or their boundaries, or by right clicking on the headings. Double 
clicking on the attributes enables a user to edit them- Items may also be dragged from 
the table onto the plot as well, or in the other direction. The selection and pen color 
attributes are kept aligned automatically between all views of the same data item. A 
user exits the application by closing the tree window. 

Data item commands, also known as JAF Commands (based on "JavaBeans 
Activation Framework") may also be implemented within XIS. The JAF API is a part 
of Java and provides a way to associate commands with object. By using JAF, 
developers may take advantage of standard Java interfaces to determine the type of an 
artitrary piece of data, encapsulate access to it, discover the operations available for it, 
and to instantiate the appropriate bean to perform said operations). For example, if a 
browser obtained a JPEG image, JAF would enable the browser to identify that the 
stream of data is a JPEG image, and from that type, the browser could locate and 
instantiate an object that could manipulate, or view that image. JAF commands are 
typically used in pop-up menus or menu bars to control objects. 

XIS uses JAF commands to control DSIs and perform operation on data items. 
Right clicking on a data item in an MoBean pops up a menu with commands that are 
specific to that data item. JAF commands with XIS may implement the following: 

- "Context Menus" or pop-up menus initiated by right clicking on a 
display that represents one (or more) data items; 
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- Command "menus' 1 may be combined into a menu for multiple objects 

(e.g., one single command (menu item) to delete all selected 
objects; 

- Addition of data item commands per object type by adding them to tbe 

"JAF" registry; 

- Addition of file/content MIME types in the display; 

- Addition to the "JAF" registry of entries that represent objects that can 

add any number of menu items dynamically; 

- JAF commands may be added by "Menu Populators" that can add 

menu items for single and multiple data items; 

- JAF commands may be added by the environment for other typical 

functions that might be performed on any object (possibly 
depending on capabilities/content of that data item), e.g., 
Copy/Paste/Cut/Delete, Hide/Show, Refers To (if the object 
exposed relationships to other objects which may or may not be 
loaded yet), Contains, Referred by, Contained by, URLs 
(attributes), Properties, etc.; and 

- Default behavior of "Properties" command may be overridden using a 

"JAF entry." 

Figures 38A, 38B, 38C, and 38D show how JAF is used within the framework. 
Figure 38A shows a menu of HelloWorld objects for selection, displayed on a screen 
of the computer system implementing the framework. Figure 38B shows that the 
HelloWorld objects are displayed through a graphing (data plot) viewer. Figure 38C 
shows the display of Figure 38B after the display cursor has been positioned over the 
bar graph, followed by a right-click. A context menu, enabling the user to select the 
"Properties'* option, is displayed in Figure 38D. In this example, the HelloWorld 
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object can be manipulated by a PropertySheetlnfoBean object Thus, selecting the 
"Properties" option results in a PropertySheetlnfoBean being instantiated showing the 
properties of the First HefloWorld object, as shown in Figure 38D. 

Another feature provided by the XIS framework is the use of attribute aliases. 

5 This enables one attribute from one domain to be substituted for an attribute in 
another domain. For illustration purposes, let us assume that we have two domains 
called Movement Domain and Physics Domain. The attribute speed in knots is 
defined in the Movement Domain, while the attribute velocity in meters/sec is defined 
in the Physics Domain. The XIS framework enables a developer to register or define 

l o that the speed attribute in the Movement Domain is similar or compatible with the 
velocity attribute in the Physics Domain. Thus a enabling a data consumer object to 
ask for the Attribute from the domain that it knows about, and have the value 
translated from the Attribute of the DSI from the second domain. 

Figure 39A, 39B, and 39C show details of an exemplary embodiment 

15 explaining how an interface for the attribute alias feature described above may be 
defined or implemented within the XIS framework The illustration includes class 
listing for objects that are used in the preferred embodiment of the framework. 

Figure 40 is a block diagram of a computer that may be used to implement the 
framework described herein. The framework may be used in a single computer, or 

20 may be used in conjunction with one or more computers that may communicate with 
each other over a network to share data. Those skilled in fee art will appreciate that 
the various data objects, framework extensions, and other processes described above 
may be implemented with one or more computers, all of which may have a similar 
computer construction to that iDstrated in Figure 40, or may have alternative 

25 constructions consistent with the capabilities described herein. 

Figure 40 shows an exemplary computer 4000 such as might comprise a 
computer in which an object oriented programming environment is supported to 
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permit the framework operations described above, and to permit the various display 
operations and computer processing events. Each computer 4000 operates under 
control of a central processor unit (CPU) 4002, such as a "Pentium" microprocessor 
and associated integrated circuit chips, available from Intel Corporation of Santa 

5 Clara, California, USA. A computer user can input commands and data from a 
keyboard and computer mouse 4004, and can view inputs and computer output at a 
display 4006. The display is typically a video monitor or flat panel display. The 
computer 4000 also includes a direct access storage device (DASD) 4008, such as a 
hard disk drive. The memory 4010 typically comprises volatile semiconductor 

10 random access memory (RAM). Each computer preferably includes a program 

product reader 4012 that accepts a program product storage device 4014, from which 
the program product reader can read data (and to which it can optionally write data). 
The program product reader can comprise, for example, a disk drive, and the program 
product storage device can comprise removable storage media such as a magnetic 

1 5 floppy disk, a CD-R disc, a CD-RW disc, or DVD disc. 

The computer 4000 can communicate with other computers over a computer 
network 4016 (such as the Internet or an intranet) through a network interface 401 8 
that enables communication over a connection 4020 between the network 4016 and 
the computer 4000. The network interface 4018 typically comprises, for example, a 

20 Network Interface Card (NIC) or a modem that permits communications over a 
variety of networks. 

The CPU 4002 operates under control of programming steps that are 
temporarily stored in the memory 4010 of the computer 4000. When the 
programming steps are executed, the computer performs its functions. Thus, the 

25 programming steps implement the functionality of the event tracking process 
described above. The programming steps can be received from the DASD 4008, 
through the program product storage device 4014, or through the network connection 
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4020. The program product storage drive 401 2 can receive a program product 40 1 4, 
read programming steps recorded thereon, and transfer the programming steps into the 
memory 401 0 for execution by the CPU 4002. As noted above, the program product 
storage device can comprise any one of multiple removable media having recorded 
5 computer-readable instructions, including magnetic floppy disks and CD-ROM 
storage discs. Other suitable program product storage devices can include magnetic 
tape and semiconductor memory chips. In this way, the processing steps necessary 
for operation in accordance with the invention can be embodied on a program 
product. 

io Alternatively, the program steps can be received into the operating memory 

4010 over the network 4016. In the network method, the computer receives data 
including program steps into the memory 4010 through the network interface 4018 
after network communication has been established over the network connection 4020 
by well-known methods that will be understood by those skilled in the art without 

15 further explanation. The program steps are then executed by the CPU 4002 thereby 
comprising a computer process. 

It should be understood that the any device that supports the framework 
envirnonment described above, acting as a host computer, will typically have a 
construction similar to that shown in Figure 40, so that details described with respect 

20 to the Figure 40 computer 4000 will be understood to apply to all computers of any 
network system in which the framework or framework-developed applications are 
utilized. Alternatively, the devices can have an alternative construction, so long as the 
computer can communicate with the other computers and can support the 
functionality described herein. 

25 All patents, patent applications, publications and references mentioned in the 

specification are indicative of the practice level of those skilled in the art to which the 
invention pertains. All patents, patent applications, publications and references arc 
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herein incorporated by reference to the same extent as if each individual patent, patent 
application, publication or reference was specifically and individually indicated to be 
incorporated by reference. 

One stilled in the art should readily appreciate that the present invention is 
well adapted to carry out the objects and obtain the ends and advantages mentioned, 
as well as those inherent therein. The specific embodiments described herein as 
presently representative, of preferred embodiments are exemplary and are not intended 
as limitations on the scope of the invention. Changes therein and other uses will 
occur to those skilled in the art which are encompassed within the spirit of the 
invention are defined by the scope of the claims. It will be readily apparent to one 
skilled in the art that modifications may be made to the invention disclosed herein 
without departing from the scope and spirit of the invention. 

The present invention has been described above in terms of presently preferred 
embodiments so that an understanding of the present invention can be conveyed. 
There are, however, many configurations for information system frameworks not 
specifically described herein but with which the present invention is applicable. The 
present invention should therefore not be seen as limited to the particular 
embodiments described herein, but rather, it should be understood that the present 
invention has wide applicability with respect to information systems generally. All 
modifications, variations, or equivalent arrangements and implementations that are 
within the scope of the attached claims should therefore be considered within the 
scope of the invention. 
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CLAIMS 

We claim: 

5 

1 . An extensible framework for use in a computer system that supports an 
object oriented programming environment and includes a memory in which data 
objects can be stored, the framework comprising a set of object classes that can be 
extended using object oriented principles to define an information handling 

10 application with data objects comprising a class of date source objects and a class of 
data consumer objects, and a mediation layer that defines an interface between the 
data source objects and the data consumer objects to permit data communications 
between the two data object classes, such that the class configuration of the data 
source objects can be specified independently of the class configuration of the data 

15 consumer objects. 

2. A computer system that supports an object oriented programming 
environment and includes access to data storage containing specifications for a set of 
object classes that can be extended using object oriented principles to define an 

20 information handbag application with data objects comprising a class of data source 
objects and a class of data consumer objects, and a mediation layer that defines an 
interface between the data source objects and the data consumer objects to permit data 
information exchange between the two data object classes, such that the class 
configuration of the data source objects can be specified independently of the class 

25 configuration of the data consumer objects. 
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• 3. A computer system as defined in claim 2, wherein the mediation layer 
defines a data interface that provides an information exchange standard between the 
data source objects and the data consumer objects. 

4. A computer system as defined in claim 3, wherein the data interface 
includes at least one attribute/metadata object class that specifies attributes, including 
metadata, and that provide declarative and procedural information relating to 
attributes in said data object 

5. A computer system as defined in claim 3, wherein the data interface 
includes at least one Relationship object class that specifies relationships between 
data source class objects. 

6. A computer system as defined in claim 3, wherein the data interface 
includes at least one Domain Policy object class that specifies a group of related 
attributes, methods, and semantic information that indicates data processing to be 
available for the specified attributes, including the specific intent of said attributes. 

7. A computer system as defined in claim 3, wherein the data interface 
includes at least one Event Change object class that specifies change event 
registration for detecting changes in the data objects. 

8. A computer system as defined in claim 4, further including a 
TypeMetaData class of objects that specify semantic information indicating data 
processing to be available for specified attributes and intended use of the attributes of 
a data object. 
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9. A computer system as defined in claim 8, further including a TypelO 
class of objects that define a desired format of a data object attribute specified by a 
TypeMetaData class. 

5 10. A computer system as defined in claim 6, wherein an attribute alias may 

be specified by a user to indicate any data source attributes of an attribute domain that 
may be substituted with attributes of a different attribute domain. 

11. A computer system as defined in claim 4, wherein said 

10 attribute/metadata interface provides input/output functions for display and editing of 
the attribute during runtime. 

12. A computer system as defined in claim 4, further including a 
FieldMetaData attribute that specifies processing criteria for an attribute of a data 

15 object 

13. A computer system as defined in claim 4, wherein the processing 
criteria relates to a selected attribute of the data object for display processing. 

20 14. A computer system as defined in claim 5, wherein the indicated 

relationship may be resolved using a version of the Relationship object in cache of the 
computer system. 

15. A computer system as defined in claim 2, further including a 
25 collaboration facility that permits a user at a network computer remote from the 
computer system to share a view of a data object at the remote network computer. 
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16. A computer system as defined in claim 15, wherein the collaboration 
facility comprises a MetaView class of data objects that lightweight encapsulate 
elements of a data object for visual reconstruction on a display screen of the remote 
network computer. 

17. A computer system as defined in claim 4, wherein the data interface 
provides an override function that can override default metadata of the data object 
attributes. 

18. A computer system as defined in claim 6, wherein the data interface 
provides an override function that can override default metadata of the data object 
attributes. 

19. A computer system as defined in claim 3, wherein data objects provided 
through the data interface comprise infonnation that specifies data attributes, 
relationships, event broadcasting of changes in all registered data consumer objects, 
metadata for attributes that provide declarative and procedural infonnation and/or 
input/output functions for display and editing, and related data items, and wherein the 
data objects can store references without direct access to a related data item. 

20. A computer system as defined in claim 19, wherein the attributes and 
relationships include contextual metadata, and the events and methods are defined 
with respect to the contextual metadata. 

21. A computer system as defined in claim 3, wherein the mediation layer 
further includes object classes that include one or more methods that provide data 
exposure^ and further including a Data Source Interface object class of data objects 
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with methods that automatically determine which data exposure method will be used 
for data communications between the data source objects and data consumer objects. 

22. A computer system as defined in claim 2 1 , wherein the determined data 
exposure method comprises data object reflection and introspection. 

23 . A computer system as defined in claim 2 1 , wherein the data exposure 
methods include a data source object method that provides a standard interface, a data 
source object and a Translator object that maps an alternate data interface to the 
standard interface, and a data source object that is inspected by tire computer system 
to determine available data fields which are thereby exposed to data consumer objects 
by the standard interface. 

24. A computer system as defined in claim 3, wherein the data interface of 
the mediation layer provides a wrapper for the data objects. 

25. A computer system as defined in claim 24, wherein data exchange 
occurs without providing contextual data characteristics to a receiving data object. 

26. A computer system as defined in claim 25, wherein the contextual data 
characteristics are supplied by the data object wrapper. 

27. A computer system as defined in claim 3, wherein data exchange occurs 
without providing contextual data characteristics to a receiving data object. 

28. A computer system as defined in claim 2, further including a plug-in 
manager object class that integrates service components into the application. 
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29. A computer system as defined in claim 28, wherein data service 
components interact with other components of the application to determine if a 
service is required and to determine parameters that axe to be interchanged 

5 

30. A computer system as defined in claim 29, wherein the service 
determination occurs upon introduction of newly loaded components. 

31. A computer system as defined in claim 3, further including a translator 
10 facility that translates information concerning a data object into (1) attributes and 

metadata that define groups of data source and data consumer class attributes and (2) 
an object class that specifies at least one domain method for defining groups of data 
object attributes. 

15 32. A computer system as defined in claim 24, further including an 

InfoModel data object class. 

33. A computer system as defined in claim 27, wherein said contextual data 
characteristics are supplied by an InfoModel object 

20 

34. A computer system as defined in claim 33, wherein the InfoModel 
object receives a data source object for exposure to the data consumer objects, selects 
available attributes and methods of the received data source object for data 
characterization, and determines if the addition of attributes or methods to the data 

25 source object are appropriate. 
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35. A computer system as defined in claim 6, wherein the domain is defined 
using XML schema. 

36. A method of communicating data in a computer system that supports an 
5 object oriented programming environment and includes data storage or access to data 

storage containing data objects and specifications for a set of object classes that can 
be extended using object oriented principles to define an information handling 
application, the method comprising: 

receiving one or more data objects comprising a class of data source objects; 
10 representing the data source objects in accordance with an Information Model 

class of objects of a mediation layer that defines a data interface between the data 
, source objects and a class of data consumer objects; 

wherein the Information Model objects include methods that permit data 
communications or information exchange between the two data object classes, such 
15 that the class configuration of the data source objects can be specified independently 
of the class configuration of the data consumer objects. 

37. A method as defined in claim 36, further including specifying at least 
one attribute/metadata object class that specifies attributes, including metadata, and 

20 that provides declarative and procedural information relating to attributes in said data 
object. 

38 A method as defined in claim 36, further including specifying a 
Relationship object class or classes that specify relationships between data source 
25 objects. 
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39. A method as defined in claim 36, further including specifying a Domain 
Policy or Domain object class or classes that specify a group of related attributes, 
methods, and semantic information that indicates data processing to be available for 
the specified attributes, including the specific intent of said attributes. 

40. A method as defined in claim 36, further including specifying an Event 
Change object class or classes that specify change event registration for detecting 
changes in the data objects. 

41 . A method as defined in claim 37, further including specifying a 
TypeMetaData class of objects that specify semantic information indicating data 
processing to be available for specified attributes and intended use of the attributes of 
a data object. 

42. A method as defined in claim 41, further including specifying a TypelO 
class of objects that define a desired format of a data object attribute specified by a 
TypeMetaData class. 

43. A method as defined in claim 39, further including specifying an 
attribute alias by a user to indicate any data source attributes of an attribute domain 
that may be subtitued with attributes of a different attribute domain. 

44. A method as defined in claim 37, wherein the attribute/metadata 
interface provides input/output functions for display and editing of the attribute during 
runtime. 
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45. A method as defined in claim 37, wherein the attribute/metadata object 
class is a FieldMetaData attribute that specifies processing criteria for an attribute of a 
data object. 

46. A method as defined in claim 37, wherein the processing criteria relates 
to a selected attribute of the data object for display processing. 

47. A method as defined in claim 38, wherein the indicated relationship 
may be resolved using a version of the Relationship object in cache of the computer 
system. 

48. A method as defined in claim 36, further including providing a 
collaboration facility that permits a user at a nework computer remote from the 
computer system to share a view of a data object at the remote network computer. 

49. A method as defined in claim 48, wherein the collaboration facility 
comprises a MetaView class of data objects that lightweight encapsulate elements of a 
data object for visual reconstruction on a display screen of the remote network 
computer. 

50. A method as defined in claim 37, wherein the data interface provides an 
override function that can override default metadata of the data object attributes. 

51. A method as defined in claim 39, wherein the data interface provides an 
override function that can override default metadata of the data object attributes. 
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52. A method as defined in claim 36, wherein data objects provided through 
the data interface comprise information feat specifies data attributes, relationships, 
event broadcasting of changes in all registered data consumer objects, metadata for 
attributes that provide declarative and procedural information and/or input/output 
functions for display and editing, and related data items, and wherein the data objects 
can store references without direct access to a related data item. 

53. A method as defined in claim 52, wherein the attributes and 
relationships include contextual metadata, and the events and methods are defined 
with respect to the contextual metadata. 

54. A method as defined in claim 36, wherein the mediation layer further 
includes object classes that include one or more methods that provide data exposure, 
and further including a Data Source Interface object class of data objects with 
methods that automatically determine which data exposure method will be used for 
data communications between the data source objects and data consumer objects. 

55. A method as defined in claim 54, wherein the determined data exposure 
method comprises data object reflection and introspection. 

56. A method as defined in claim 54, wherein the data exposure methods 
include a data source object method that provides a standard interface, a data source 
object and a Translator object that maps an alternate data interface to the standard 
interface, and a data source object that is inspected by the computer system to 
determine available data fields which are thereby exposed to data consumer objects by 
the standard interface. 
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57. A method as defined in claim 36, wherein the data interface of the 
mediation layer provides a wrapper for the data objects. 

58. A method as defined in claim 57, wherein data exchange occurs without 
5 providing contextual data characteristics to a receiving data object 

59. A method as defined in claim 58, wherein the contextual data 
characteristics are supplied by the data object wrapper. 

10 60. A method as defined in claim 36, wherein data exchange occurs without 

providing contextual data characteristics to a receiving data object 

61 . A method as defined m claim 36, further including a plug-in manager 
object class that integrates service components into the application. 

15 • 

62. A method as defined in claim 61, wherein data service components 
interact with other components of the application to determine if a service is required 
and to determine parameters that are to be interchanged. 

20 63 . A method as defined in claim 62, wherein the service determination 

occurs upon introduction of newly loaded components. 

64. A method as defined in claim 36 > further including a translator facility 
that translates information concerning a data object into (1) attributes and metadata 
25 that define groups of data source and data consumer class attributes and (2) an object 
class that specifies at least one domain method for defining groups of data object 
attributes. 
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65. A method as defined in claim 57, further including an InfoModel data 
object class. 

5 66. A method as defined in claim 60, wherein said contextual data 

characteristics are supplied by an InfoModel object. 

67. A method as defined in claim 66, wherein the InfoModel object receives 
a data source object for exposure to the data consumer objects, selects available 

10 attributes and methods of the received data source object for data characterization, 
and determines if the addition of attributes or methods to the data source object are 
appropriate. 

68. A method as defined in claim 39, wherein the domain is defined using 
15 XML schema. 

69. A computer system that supports an object oriented programming 
environment, the system comprising: 

^a processor that executes program instructions to provide the object oriented 
20 programming environment; and 

data store means for providing program instructions containing specifications 
for a set of object classes that can be extended using object oriented principles to 
define an information handling application with data objects comprising a class of 
data source objects and a class of data consumer objects, and a mediation layer that 
25 defines an interface between the data source objects and the data consumer objects to 
permit data information exchange between the two data object classes, such that the 
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class configuration of the data source objects can be specified independently of the 
class configuration of the data consumer objects. 

70. A computer system as defined in claim 69, wherein the mediation layer 
defines a data interface that provides an information exchange standard between the 
data source objects and the data consumer objects. 

71 . A computer system as defined in claim 70, wherein the data interface 
includes at least one attribute/metadata object class that specifies attributes, including 
metadata, and that provide declarative and procedural information relating to 
attributes in said data object. 

72. A computer system as defined m claim 70, wherein the data interface 
includes at least one Relationship object class that specifies relationships between 
data source class objects. 

73. A computer system as defined in claim 70, wherein the data interface 
includes at least one Domain Policy object class that specifies a group of related 
attributes, methods, and semantic information that indicates data processing to be 
available for the specified attributes, including the specific intent of said attributes. 

74. A computer system as defined in claim 70, wherein the data interface 
includes at least one Event Change object class that specifies change event 
registration for detecting changes in the data objects. 

75. A program product for use in a computer system that executes program 
instructions recorded in a computer-readable media to perform a method for 
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information exchange in a computer system that supports an object oriented 
programming environment and includes access to data storage containing data 
objects, the program product comprising: 
a recordable media; and 

a program product of computer-readable instructions executable by the 
computer system to perform a method comprising: 

receiving data specifications for a set of object classes that can be extended 
using object oriented principles to define an information handling application, 
wherein the extended objects provide an information handling application that can 
receive one or more data objects comprising a class of data source objects, and 
represent die data source objects in accordance with an Information Model class of 
objects of a mediation layer that defines a data interface between the data source 
objects and a class of data consumer objects; 

wherein the Information Model objects include methods that permit data 
communications or information exchange between the two data object classes, such 
that the class configuration of the data source objects can be specified independently 
of the class configuration of the data consumer objects. 

76. A program product as defined in claim 75, wherein the method further 
includes specifying at least one attribute/metadata object class that specifies attributes, 
including metadata, and that provides declarative and procedural information relating 
to attributes in said data object. 

77. A program product as defined in claim 75, wherein the method further 
includes specifying a Relationship object class or classes that specify relationships 
between data source objects. 



119 



WO 02/46916 



PCT/US01/48418 



78. A program product as defined in claim 75, wherein the method further 
includes specifying a Domain Policy or Domain object class or classes that specify a 
group of related attributes > methods, and semantic information that indicates data 
processing to he available for the specified attributes, including the specific intent of 

5 said attributes. 

79. A program product as defined in claim 75, further including specifying 
an Event Change object class or classes that specify change event registration for 
detecting changes in the data objects. 

10 

80. A method of operating a computer system to execute an information 
handling application in an object oriented programming environment and to receive 
data from a class of data source objects and provide a class of data consumer objects 
with data, the method comprising: 

is selecting available attributes and methods of a data source object for 

characterization; 

determining attributes or methods to be added to the data source object during 
application execution; and 

receiving the data source object and determining whether to expose or hide 
20 available attributes and methods of the object from data consumer objects, wherein 
data communications between the two data object classes is supported, such that the 
class configuration of the data source objects can be specified independently of the 
class configuration of the data consumer objects. 
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Figure 6A 
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Package com.xis.types 

This package contains classes that provide several standard TypeMetaData classes for describing types and their 
constraints, and Tor rendering and editing values of those types. 



See: ■ 

D escription 



Interface Summary 




The DataTcst interface specifics methods for Object validation. 




This interface defines the 10 for HTML. 


*J *f nit/uiry i u nciiQH 


The Summary Function* interface defines generic summary functionality based upon provided 
input data values. 




The SwingTypelO Interface allows for the use of both swing editors, allowing swing 
components to edit an object, and swing Tenderers, which know how to render these objects in 
a swing environment. . 




The TaxtTypalO interface provides a means of formatting objects in a textual fashion, as well 
as parsing text from which an object is created. 




The TypedValua interface is used to hold an object that carries its own TypeMetaData with 
it • 


TvneEttitor 


The TypeEditor interface defines methods for editing attributes provided by the types 
implemented within this package. 


TypelQ 


The TypelO interface provides a common base from which other TypeiOs can extend, such as 
RTMLTypelO, SwingTypelO, etc. 


TypeMetaData 


The TypeMetaData interface defines generic type accessor* for object comparing, editing, 
formatting, rendering, and validation. - 


TypeMcta Data Factory 


The TypertetaData Factory interface defines a class that can, create TypeMetaData for a . 
given Class Type. 


TvpeRenderer 


The Type&enderec interface defines methods for rwdering attributes provided by the types 
implemented within this package. 


ValidTtttPrttxv 


The ValidTestProxy interface 


WMLTvpeEdilor 


The WMLTypeEditor interface defines methods for rendering attributes provided by the types 
implemented within this package. 


miLTypefO 


This interface defines the 10 for WML format 


WMLTypeRmdtfcr 


The WMIiTypeRenderer interface defines methods for rendering attributes provided by the 
types implemented within this package. 


XiWLTypelO 


The XMLTypelO interface provides a means of formatting objects in a XML textual fashion, as 
well as parsing XML text for creating an object 
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Class Summary 


AbstractDataTest 


Tne AbstractDataTesc class provides a default implementation of test 




&h^rjn>^PunoM»t > anatA nrovides a partial unDlementationof 
TypeMetaData to relieve the XIS developer &om explicitly implementing 
irrelevant methods. 




AceaOfUncertaincyTypeHetaQata is a type object that supports 
AreaO/UncertaOtty objects. 


ArrayListTvp^MetaData 


ArrayUstTypeKe'taData is a type object that supports 
yova utiLArrqyList objects . 


^rra V TYpeMetaDflta 


ArrayTypeMetaData is a type object thatsupportsyava/ang.rey/ec/./trray 
objects. 


BeanTvpeMetoDato 


BeanTypeMetaOata is a type object that supports javabeans objects. 


Pqp|eanTVP?(Y|^tanata 


The BooleanTypeMetaUata is a type oojeci uiai suppuro ouviKun uujclw. 


Rnnion nTvn^M ptaTlataFactorv 


A BooleanTypeMetaDacafaccory can create a 
BooLeanTypeHetaOata for given booleans. 


CachedTvDeMfetaData 


. _ jrri. ^«»Lf r-w ► t- a i« a tvn^ nhiect that simolv delegates all ■ 

CacnadTypeMecauata is a iypc uujc>-v uuu. am^i; ^^'^o 
TypeMetaData calls to another TypeMetaData. 


Cla3Sincat>ORTvcgM£tanata 


ClaSSif iCatiOnTypaneCauaca la a i/ps vujfcwi. un>^ Jk *rr w 

Classification objects. 


CDl1ect>on5TYpeM_e,taX^i5 


CallcctionsTypeMetaDaca is a type object that supports Collection 
objects. 


ColprTvpcjVletaData. 


The ColorTypeMetaData class implements TypeMetaData for Color 
objects. f 


CoCorTypeMetaData£a£taxx 


A ColcrTypeMetaDataFactory can create a ColorTypeMetaData for 
a given Color object. 


fftnvprtlnnNumeHcTVDcMetaDatfl 


A generic NurnericTypeMetaData for converting from one unit to another. 




CurrencyTypeMetaData is a type object chat supports Number objects 
that represent Currency values. 


r\n i _ T* t i-n r\T" \i na.KA a til 


DateTiiaeTypeKetaData is a type object that supports Date objects. 




A Da teTimaTypeMetaDat a Factory can create a 
DateTLmeTypeMetaData for given Date objects. 


Dis e re 1 1 Ra npeS t ri nfiTypeM* ta D a ta 


OiscretaRangeStringTypeMetaOa ta is a type object that supports 
String objects with discrete ranges. 


Di5playLab C !Type|VletaDaU 


DisplayLabelTypeMetaData is a type object that supports supports 
DisplayLabei objects. * 


DTGTypelMetaData 


OTGTypaMataData is a type object that supports Dau objects. 


EnumerationType 


Class to implement an enumeration in Java. 


EnumerationTvpeMetaOaia 


The EnumerationTypeMetaData class is used to represent integer 
constants as strings to the user. 


FontTvneMetaData 


TontTypeMetaData is a type object that supports Font objects. 


HashMapTyp^M^taDala 


HashMapTypeMetaOaca is a type object that sup ports jw>a.utiLHashMap 
objects. 



f VS. I 2 - B» 
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HashSetTYDeMttaData 


HashSetTypeMetaOata is a type object thai supports javQ.u(iLHashSet 
objects. 




iconShapeTypefriecaOaaa is a type object that supports fconShape 
objects. 




IconTypeMetaOata is a type object that supports Icon objects. 




LinfcedLiatTypeMetaData is a type object that supports 




Li s tTypeMata Oa fca is a type object that supports jova.utiL List objects. 




The HouseMapProay class allows TypeEditors access to the map without 
requiring mem io naYing any compile umc Knowledge oc tnc map s. 
existence. 


LLUinQg rv,o m na ra to r 


An implementation of the Comparator interface that compares two objects 
inac exiena r«umoer t or cnai do in implement twOmparaoie, witn tne class of 
one assignable from the other. 


numeric ^ ypetvicu uaia 


NmnaricTypeMetaDa is a type object that supports Number objects. 


Numeri«TvpeMctaDataFnctorv 


A NumericTypeMata Data Factory can create Hume ricTypeWeta Data 
tor a given ciass type or rneuiou return type. 


• 

ObjectTypeM etaData 


Ob j eccTypemetaData is a type thai supports a simple Object and is 
provided to quickly add arbitrary attribute types to a Data Source interface 
wiuioui writing a mure specuic type nanoier. 


PercentTvoeMBtaData 


PercentTypeMetaOata is a type object that supports Number objects that 
represent Percent(%) values. 


ProbabiUtvTvneMetaData 


probabilityTypeMecaOata is a type object that supports Number 
objects that represent Probability values. 




RenamedTypeMetaData simply delegates all TypcMetaData calls to 
another TypeMetaData except for the getNameQ, which is overridden with 
the given value. 




ResizedTextTypeMetaData simply delegates all TypeMetaData calls to 
another TypeMetaData except for the getPixetWidthQt which is overridden 
with the given value. 


Resources 


The Resources class is automatically generated and must be public, but it 
is intended to be used only by Java's internationalization support classes. 


J^^a^tJjup^ l t^pnJ/ype^yJe^aual3 


A SmartDurationTypeMetaData for converting from one time unit to 
another based on the magnitude of the duration value, 


5tnngTypeMetaDaU . 


S tringTypeMetaData is a type object that supports String objects. 


StringTypeMetaDataFactory 


A StrtngTypeMetaOataraccory can.create a StringTypeMetaDaca 
for a given String object. 


TextTvpeM eta Data 


TextTypeMetaData is a type object that supports Text objects. 


Typed YaiueType^etaData 


TypedVaiueTypeMecaData is a type object that supports supports 
TypzdValu* objects. 


TypeEditorBeq n Con textChjjdS uppo rt 


The TypeSditocBeanContextChildSupport class handles most of the 
responsibilities of a TypeEditor and a BcanContextChild. 


TvoeEdKorSuDpoii 


The TypeEditor Support class handles most of the responsibilities of a 
TypeEditor. 


TypeJQPluggableService 


The TypelOPluggableService class is responsible for loading TypelQs. 


TypelORfrsiatry 


The TypelORegistry class is a registry for different implementations of 
Type 10 classes. 



fl(S. fee 
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TvoeiOSuooort 


ThA fx^»Tn«?iinnrirt nmvides suoDOrt for TypeMetaData's getTypelO 
methods. 


lyjgjfleJ&P a taDelegatoj; 


TypeMecaOataOeiegatoc is a type object that simply delegates all 
TypeMetaData calls to another TypeMetaData. 


lypsCde^JMaEa^ 


The TypeWetaOatatactoryPLuggaDLeSeirvice class b responsible for 
loading TypeMetaDataFactories. 


TvpeMetaDatnFaetorvSiars 


This Class stores TypeMetaDataFactories. 


lypep/eferences 


This class is used by TypeMetaData instances to pass information about 
preferred TypeMetaData objects. 




The Types class is a holder class for the RESOURCES global variable for 
resource properties of the com jcis. types package. 




URLTypeHetaOata is a type object that supports URL objects. 



Exception Summary 


r 


NoSuehEnurn^rationExceonQn 


Class to implement an enumeration exception in Java. 


PnttPPftlledExceotion 


A ParsaFailedException is thrqwn (typically by TypelO objects) when it is not 
possible to parse a given String as desired. 


TestFaileriEmption 


The Test Fa U exception is thrown fom the "testO" method of a DataTest 
subclass when the value fails the test. 



Package coiruxis.types Description 

This package contains classes that provide several Standard TypeMetaData classes for describing types 
constraints, and for rendering and editing values of those types. 
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Figure 15 

HelloWortdjava 

/* XIS Tutorial standalone sequence example 1 data class. */ 

public class HelloWorld { 
* private float value - 1 .5f; 

public String toString() { 
return "Hello World!"; 

} 

public int getlD(){ 
returns; 

} 

public float getValue() { 
return value; 

} 

// uncomment this to make "value" editable 
/* 

public void setValue(float value) { 
this/value = value; 

} 
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Figure 16A 
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TestHarness.java 

/* XIS Tutorial standalone sequence example 1 XIS interfacing. */ 
import javax.swing JFrame; 
import java.awtevent.WindowAdapter, 
import java.awteventWindowEvent; 
import com.xis.propertysheetPropertySheetlnfoBean; 
import com.xis.uLUIBeanEvent; 
import com.xis.ui.UIBeanAdapten 
import c»m.xis.leif.im.BaselnfoModel; 

public class TestHarness { 

public static void main(StringQ args) { 

//the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaseInfoModel.setStartingPluglnManager(false); 

// a property sheet infobean to display HelloWortd's attributes 
PropertySheetlnfoBean properties = new PropertySheetlnfoBean(); 
properties.addRawData!tem(new HelloWorld()); 

// add listener for 'OK/ •cancel/ or close, which generate •close* events 
properties.addUIBeanListener( 
new UIBeanAdapterQ { 
public void closed(UIBeanEvent event) { 
System.exit(O); . 

} 

} 

); 



M604 
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y i6os 



// a top-level frame to hold our property sheet infobean 
JFrame frame = new JFramef'HelloWorfd Properties");. 
// add a listener for window closing 
frame.addWindowListener( 
new WindowAdapter() { 

public void windowClosing(WindowEvent e) { 
System, exit{0); 

} 



r 161 OA 



); 



} 
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Figure 16B 

Continuation of TestHarnessjava 



// stick the bean In the frame and display it 

frame.getContentPane().add(properties); 

frame.pack<); 

frame.setVisible(true); 



> 1610B 
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Figure 17 
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Figure 18A 

HelloWorld.java 

T XIS Tutorial standalone- sequence example 2 data class. *1 

r{7 

Import java.awt.Color; 

import java.beans.PropertyChangeSupport; 

import java .beans.PropertyChangeListenen 

n*/ 

public class HelloWorid { 

ret 

private int value = 1; 

private Color myColor = Color.green; 



r II this member class helps distribute property change events. within XIS 
private PropertyChangeSupport propertyChangeSupport = 
new PropertyChangeSupport(this); 

II two aux methods to let other XIS objects pay attention to this one 
public void addPnDpertyChangeListener(PropertyChangeListenerl) { 
propertyChangeSupporLaddPropertyChangeListener(l); 

} 

public void removePropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupportremovePnopertyChangeListener(l); • 

} 



public String toStringQ { 
return "A HelloWorid Object" ; 

} 

public String getGreeting() { 
return "Hello World!"; 

} 

un 

public int getlD() { 
return 5; 
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Figure 18B 

Continuation of of HeHoWorld.java 



public r?t int /*}*/ getVaiue() { 
return value; 

} 

public void setVa!ue(int value) { 
// only update and fire property change if this is really a change 
If {this.value != value) { 
Int oldValue ■ this. value; 
this.value = value; 

// fire property change event to notify other XI5 objects 
propefiyChangeSupport-flrePropertyChangeCValue'', oldValue, value); 1 

} 

} 

public Color getMyCotor() { 
return myColor; 

\ 

public void setMyColor(Color myColor) { 
// only update and fire property change If this is really a change 
if (this.myColor != myColor) { 
Color oldMyColor = this, my Color, ■ 
this.myColor= myColor, 

// fire property change event to notify other XIS objects "7 . ii 
propertyChangeSupportfirePropertyChange("myGolor", V \2> 0 ^ 
oldMyColor, myColor); . J 

} 

V } - 
./*>*/ 

} 
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Figure 19A 

TestHarness,java 

r XIS Tutorial. standalone sequence step 2 XIS interfacing. */ 

import javax.swing.JFrame; 
import java.awteventWindowAdapter; 
import java.awt.eventWindowEvent; 
import com jcis.propertysheetPropertySheetlnfoBean; 
import com.xis.uLUIBeanEvent; 
import com.xis-uKUIBeanAdapter; 
import com.xisJeif.im.BaselnfoModel; 
/*{*/ 

import jcIass.chart.JCChart; 
import com,xis.plot.PlotlnfoBean; 
import com.xis.plotchartviews.LeifChartView; 

m 

public class TestHarness { . 

public static void main{Stringfl args) { 

//the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaseInfoModeLsetStartingPluglnManager(fa!se); 

HelloWorid hello = new HeIIoWor1d(); 

II a property sheet infobean to display JHelioWorid's attributes w 1 

Property SheetlnfoBean properties = new RropertySheetlnfoBeanQ; 
properties.addRawDataltem(hello); 

// add a listener for 'OK' or 'cancel*, which generate 'close' events 
properties.addUIBeanListener( 
new UiBeanAdapter() { 

public void c!osed(UIBeanEvent event) { 
System.exit(O); 

} 

} 

); 
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Figure 19B 

Continuation of TestHamess.java 



/*{7 *"X 

// a top-level frame to hold our property sheet infobean » 
JFrame propertySheetFrame = new JFramefTlelloWoricl Properties 11 ); 
// add a listener for window closing 
propertySheetFrame.addWindowListener( 
new WindowAdapterQ { 
public void windowClosing(WindowEvent e) { 
System.exit(0); 

} 

} 

); 

// stick the property Sheet bean in the frame and display it y - & a 

propertySheetFrame.getContentPane().add(properties); VH 
propertySheetFrame.pack(); 
propertySheetFrame.setVisibIe{true); 

II now we create a plot infobean to plot HelloWorld's numeric attribute 



i < PlotlnfoBean plot = new PiotlnfoBean(); 
ft L P lot -addRawDataftems(new OfajectQ { hello }); 



plot.setChartType(JCChart.BAR); 

//the alternatives are SCATTERJ^LOT, PLOT, AREA, PIE, CANDLE, 
// and STACKI NG_BAR, though not all will make sense In this example 

// a top-level frame as before to hold our property sheet infobean 
JFrame plotFrame = new JFrame("HelloWor1d Plot*); 

// stick the plot bean in and put it up 
plotFrame.getContentPane().add(plot); J 
plotFrame.pack(); - S 

plotFrame.setVisible(true); 



} 
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Figure 20 



^Hfelioyfoa^Pfopciirc ^ ; : ; ;; , HHJE3 



J>*'*'? ? * Property-^ ~1 ~ [ " ' Value, " , 7^ 



P4_ 



ID 



5 

1* 



S? Name 



A HeiloWorld Object 



1v-.^ y- 



i-i Value 



Greeting 



Hello World! 



faly Color 



- 'f ; • r ''.C A. :V^>^C'X^-V-.. ' -'-V--; 



WO 02/46916 



30/90 



PCT/US01/48418 



Figure 21 

HeltoWorldJava 

r XIS Tutorial standalone sequence step 3 data class. */ 
import java.awt Color; 

// (property change support moved to HelloWorldTranslator) 

public class HelloWorld { 
private int value = 1; 
private Color myColor = Color.green; 

public String toString() { 

return "A HelloWorld Object*; 

' } 

. public String getGreeting() { 
return "Hello World!"; 

} 

public int getlDQ { 
return 5; 

} 

. public int getValue() { 
return value; 

} 

./*{*/ 

public void setValue(int value) { 

// all the worrying about change events is moved to the translator, 
// so we just need to do the bare change operation (unless noaXIS 
// components need to listen to PropertyChanges) 
this.value = value; 

}. 

n*i 

public Color getMyColor() { 
return myColor; 

} 

public void setMyColor(Cotor myColor) { 
■ // just need to set the value (see setValueO) 
this. myColor = myColor; 

} 

/*}*/ 



} 
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Figure 22A 



HeUoWorldTranslatorJava 

r XIS Tutorial standalone sequence step 3 data translator class. */ 

import rom.xisJeif jm.AttributeGetRequest; 
* import com.xisJeif.im.AttributeSetRequest; 
import corruds.leif Jm.Domain; 
import com.xis.leif.irn.Translaton 
import com.xis Jeif Jm.FieldMetaData; 
. import com.xis.domains.dlsplay.DisplayDomain; 
import com.xls.domains.movementMovementDomain; 
import java.awt.Cobr; 

public class HelloWoridTranslator extends Translator { 

// the domains from which canned attribute metadata will be taken 
// NOTE if an attribute appears In the methods below but its domain 
// is NOT listed here. THE ATTRIBUTE WILL BE IGNORED BY XIS 
private static final DomainQ baseDomains = new Domainfl { 
DisplayDomaiagetDomainOt MovementDomain.getDomainO 

}; 

J U store info about the fields, such as whether they are preferred or not 
J private Fieldi\/letai3ataD fieldMetaDataArray; 

// Return the Domains that describe the Attributes* 
q\ j public DomainQ getBaseDomainsQ { 
V L return baseDomains;. 
} 

// this method returns info on each field defined in the methods below 
f public FieldMetaDataQ getReldMetaDataArrayQ { 

if (fieidMetaDataArray null) { 

// initialize default metadata 
FieldMetaData dispname = new 

FieldMetaData(DisplayDomain.dlsplayName); 

FieldMetaData pencolor = new 

FteldMetaData(DisplayDomain.penCobr); 

FieldMetaData speed = new 

FieldMetaData(MovementDomain.speed); 

FieldMetaData course = new 

FieldMetaData(MovementDomain.course); 
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} 



Figure 22B 

Continuation of HelloWorldTranslator.java 

// attributes are visible ('preferred') by default; this 
// turns this off for the course attribute 
course.setVisibility(false); 

// the order we put the attributes in here determines the order 
// they appear in tables or property sheets 
fieldMetaDataArray = new FieldMetaDataQ { • 
dispname, speed, course, pencolor 

>; 



} 



return fieldMetaDataAnray; 



mmnuimmimmummmiumiimimmmwmm 

II the following methods expose attributes of the HefloWorid class; 
// instead of calling the class methods directly, XiS will access 
// everything through this translator class 

imumimimimiumimmmiumimiiiiiimimiiH 

public String getDisplayName(AttributeGetRequest attributeGetRequest) { 
return ((HeiloWorld) 

attributeGetRequest.getRawDataltem()).toString(); 

public Color getPenColor{AttributeGetRequest attributeGetRequest) { 
return ((HeiloWorld) 

attributeGetRequest.getRawDataltem()).getMyColor(); 

public void setPenColor(AttributeSetRequest attributeSetRequest, 
Color penCoIor) { 
HelloWorid helloWorid = (HeiloWorld) ' 

attributeSetRequestgetRawDataltem(); 
Color oldPenCoIor = helloWorld.getMyColorO; 
if (lpenColor.equals(oldPenColor)) { 
helloWorld.setMyColor(penCoIor); 
// fire property change event to notify other XIS objects 
attributeSetRequest,getBaseDataltem().fireAttributeChanged( 
DisplayDomain.penColor, oldPenColor, penColor, true); 

} 

} 

public double getSpeed(AttributeGetRequest attributeGetRequest) { 
return (double) ((HelloWorid) 

attributeGetRequestgetRawDataltemO).getValue(); 

} 
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Figure 22C 

Continuation of HelloWoridTranslator.java 

public void setSpeed(AttributeSetRequest attributeSetRequest, 
double speed) { 
HelloWorld helloWortd = (HelloWorid) 
. ~ • a ttributeSetRequest.getRawDateltern(): 

n \° J Double oldSpeed = new Doubte((double)heiloWorld.getValue()); 
V \ if (oldSpeed.doubleValue() != speed) { V 7.2-\Z. 

helk)Worid.setVaIue((int)speed); 
// fire property change event to notify other XIS objects 
attributeSetRequestgetBaseDataltemO-fireAttributeChanged( 

MovementDornain.speed, oldSpeed, new Double(speed). true); 



//this is a dummy attribute to demonstrate field metadata i i^ 0 d 

public double getCouree(AttributeGetRequest attributeGetRequest) { 1 
return (double) 0; 

} 

// uncomment this to allow reflection to expose additional attributes 

// (see documentation under "Fooling Around") 

// public HelloWoridTranslatorO { 

// introspectExcept(new StringQ {"value", "myColoi- }); 

4 } 

ryi 

} ■ 
/*}*/ 
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Figure 23A 

TestHarness.java 

/* XIS Tutorial standalone sequence step 3 XIS interfacing. */ 

. import javax.swing. JFrarne; 
Import java.awtevenLWindowAdapten 
import java.awtevenLWindowEvent;- 
import com.xi5.propertysheetPropertySheetlnfoBean; 
import com.xis.uLUIBeanEvent; 
import com.xis . ui. U i BeanAdapten 
import comjdsJeifJm.BaselnfoMode!; 
import jclass.chartJCChart; 
import com.xis.plot.PiotlnfoBean; 
import com.xis.plot.chartviews.LelfChartV[ew; 

n*i 

import com jds.teif jm.TranslatorRegistry; 

import com.xisJeif.iraLeifDataltem; 

import comodsJeif.im.lnfoModel; 

import com.xis.lejf.im.BaselnfoModel; 

import com jds.domains.rnovement.MovementDomain; 

import com.xis.domains.rnovement.MovementDomainWrappen 

import com.xis.Ieif.im.LeifDataltemDelegator; 

import javaJang.reflectJnvocationTargetException; 

import com.xisJeif.im.UndefinedLeifAttributeException; 

public class TestHarness { 

protected static LeifDataltem leifHello; 
static { 

// Register the translator for HeiloWorid. In fact this is really 
// only necessary when we have not followed the standard naming 
// convention (see docs), but it can't hurt. 
TranslatorRegistry.getTranslatorRegistry().registerObjectSchema( 
HeiioWorid.ciass, HeiloWoridTranslator.dass); 

} 

l*YI 

public static void main(StringQ args) { 

// the piugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
Base1nfoModel.setStartingPlug!nManager(false); 




HeiloWorid hello ■ new HelloWorldQ; 
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Figure 23B 

Continuation of TestHarness Java 

// a property sheet infobean to display HelloWorld's attributes 
PropertySheetlnfoBean properties s new PropertySheet!nfoBean(); 
properties.addRawDatalteni(heiio); 

// add a listener for 'OK or 'cancel', which generate 'close' events 
properties.addUIBeanListener{ 
new UIBeanAdapterO { 
public void ctosed(UlBeanEvent event) { 
System.exit(0); 

} 

} 

); 

// a top-level frame to hold our property sheet Infobean 
JFrame propertySheetFrame » new JFramefHelloWorld Properties"); 
// add a listener for window closing 
propertySheetFram9.addWindowListener{ 
new WindowAdapter() { 
public void windowClosing(WindowEvent e) { 
System.exit(0); 

} 

} 

); 

// stick the property Sheet bean in the frame and display it 
propertySheetFrame.getContentPane().add(properties); 

propertySheetFrame.pack<); . , 

propertySheetFrame.setVisible(true); 
// now we create a plot infobean to plot HelloWorld's numeric attribute 
PlotinfoBean plot = new PlotlnfoBeanQ; 
plot add RawDataltems(new ObjectQ { hello }); 
plot.setChartType(JCChart. BAR); 

// the alternatives are SCATTER J=>LOT, PLOT, AREA, PIE, CANDLE, 
II and STACKING_BAR, though not ail will make sense in this example 

It We can set the attribute for initial display on tine plot; 
// if we do, this must consist of the attribute name preceded 
// by the fully-qualified ciassname which ORIGINALLY DEFINES . 
// the attributeDescriptor - i.e., using "HelloWorld.speed" 
// here will NOT work! If the descriptor is not defined in a 
// domain or translator class, then it will have been defined 
// dynamically through introspection when the first instance 
// of the data item is dropped into an XIS InfoBean. 
plot.setYAxisAttribute( 
"com.xis.domains.movement.MovementDomain. speed"); 
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Figure 23C 

Continuation of TestHarness.java 

plotsetDynamicAdjustment(true); // so axes track value magnitude 
plotsetBarChartAdjusting(true); // needed in some cases for bar chart 

// a top-ieve! frame as before to hold our plot infobean 
JFrame plotFrarne = new JFrame("HelloWorid Plot"); 

// stick the plot bean in and put it up 
piotFrame.getContentPaneO-add(plot); 
plotFrame.pack(); ■ 
plotFrame.set\/isible(true); 



// create a letfDataltenn version of hello and start a thread that 
// will increase it 
leifHello = 

BaseInfoModei.getBaselnfoModel().getLeifDataltem(hello); 
new Accelerate(); 

} H main 

} 

/*{*/ 

// thread to update the speed attribute on the leifHello instance we created 
class Accelerate extends Thread { 

public Accelerate() { 
superCAccelerator Thread ,, ); 
startO; 

} 

public void run() { 

// wrap the LeifDataltem leifHello In a convenience wrapper that 
// gives access to attributes within that domain, if they exist 
MovementDomainWrapper helloMovementWrapper = 
MovementDomain.takeWrapperfTestHarness.leifHello); 
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Figure 23D 

Continuation of TestHamessJava 



while (true) { 

// sleep for 0.5 seconds, then... 

try{ 

sieep(500); 
} catch (lnterruptedException e) { 

System.exit(1); 

}' 

// ..update the speed attribute 
try{ 

hel!oMcwemefttWrapper.setSpeed( 

he!IoMovementWrapper.getSpeed()+1); 

} catch (UndefinedLeifAttributeException uiae) { 
II exception if this data item doesn't have this attribute 
System.exit(l); // usually we would do something better 

} catch (InvocationTargetException ite) { 

II sweep up any exception tossed by the underlying raw item 
System.exit(t); // usually we would do something better 

} 

}// while 
}//runfl 

};. 

/*}*/ 
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Figure 24A 
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Figure 24B 
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Figure 25 A 



HelloWorld.java 

/* XIS Tutorial standalone sequence step 4 data class. */ 
Import java.awLColor; 

rn 

Import com.x!s.leff.iraFieIdMetaData; 
Import com jds,domains.display.DisplayDomain; 
import com.xis.domains.movementMovementDomain; 
import com j(is.lerf Jm.Domain; 
import com jds.leif.im.AttributeGetRequest; 
import com.xis.leif Jm.AttributeSetRequest; 
import com.xis.Ieif.infLAttributeDescriptor; 
import java.beans. PropertyChangeSupport; 
Import Java.beans.PropertyChangeUstenen 

rri * 

public dass HeltaWorld { 

private int value » 1; 
private Color myColor = Color.green: 

/T/ *1 
public static AttributeDescriptor getDisplayNameDescriptorQ { J 
return DisplayDomain.displayName; V 

public static AttributeDescriptor getSpeedDescriptor{) { 
return MovementDomain.speed; . 

} 

public static AttributeDescriptor getPenCo!orDescriptor() { j 
return DisplayDomain.penColor, 

} • 

n*t 

/*{*/ // this property change support code as in step 2 /*}*/ 
// this member class helps distribute property change events within XIS 
private PropertyChangeSupport propertyChangeSupport = 
new PropertyChangeSupport(this); 

// two aux methods to let other XIS objects pay attention to this one ■ y l£Ql\ 
public void addPropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupportaddPropertyChangeListener(l); 

> ■ 

public void removePropertyChangeListener(PropertyChangeUstener I) { 
propertyChangeSupport. removePropertyChangeListener(l); 

} 
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Figure 25B 

Continuation of HelloWorldjava 

public String toString() { 
return **A HelloWorld Object"; 

} 

public String getGreeting() { 
return "Hello World!"; 

} 

public int getlDO { 
return 5; 

} 

public int getValueQ { 
return value; 

} 

/*{*/ // this function as in step 2 /*)*/ 
public void setValue(lnt value) { 
// we only want to update and fire property change if really changes 
if (this.value != value) { 
int oldValue = this,va!ue; 
this.value ■ value; 

// fire property change event to notify other XIS objects 
propertyChangeSupportfirePropertyChangefvalue", oldValue, value); 

> 

}- 
/*{*/ 

// "myColor"-related methods changed to expose "penColor" instead 

public Color getPenColorQ { 
return myColon 

} . 

public void setPenColor(Color penColor) { 
II we only want to update and fire property change if really changes 
if (penColor 1= this.myColor) { 

Color old PenColor = this.myColor; 

this.myColor = penColor; 

// fire property change event to notify other XIS objects 
propertyChangeSupport.firePnopertyChangerpenColor", 

oldPenColor, penColor); 

} 

} 
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Figure 25C 

Continuation of HelloWortdjava 

// expose toStringO return under a new name 
public String getDisplayNameQ { 
return toStringO; 

} 

// expose "value" under a new name 
public double getSpeed{) { 
return (double) getValueO; 

} 

public void setSpeed(double speed) { 

• // we only want to update and fire property change if really changes 
Double oldSpeed = new DoubIe((double)this.getValue()); 
If {speed 1= oidSpeeddoubleValueO) { 
setValue((lnt)speed); 

// fire property change event to notify other XIS objects 
propertyChangeSupport.firePropertyChange( w speed ,r , oldSpeed, 

new Double(speed)); 

} 

} 

ryv 
r{7 

// store info about the fields, such as whether they are preferred or not 
private static FieldMetaDataQ fieldMetaDataArray; 

// this method returns info on each field defined in the methods below 
public static FieldMetaDataQ getReldMetaDataArrayQ { 

if {fieldMetaDataArray == null) { 
// initialize default metadata 
FieldMetaData dispname = new 

FieldMetaData(DisplayDomain.displayName); 
FieldMetaData pencolor= new 

FieldMetaData(DisplayDomain.penColor); 
FieldMetaData speed = .new 

FieldMetaData(MovementDomain.speed); 
// could customize the field metadata here 
fieldMetaDataArray = new FieldMetaDataQ { 
dispname, speed, pencolor 

}; 

} 

return fieldMetaDataArray; 
} ' 

ryr 
} 
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Figure 26 
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Figure 27A 
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Figure 27B 
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Figure 28 
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Figure 29 
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Figure 30 
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Figure 32 
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Class ContentlnfoBean 

I , m ■ 

i • 

i ■ ■ 

+ — ?avax .a wing. ^C ° ^DQnsnt 

I ' 
+--ja vax,swino. JPanel, 

I . . 

+--com. xia . ui ^Aba t cac tUIBean 
" • I 

»--£Qj5_^3 . la U,»,in£ obqapa T Oflta Etem$j P HP jBean 
J 

+~-ccaa. xi* - infcihaans . content. Con ten tlrtfoBean 

AH Implemented Interfaces: 

Accessible. BeanContextChildOwner. BeanContextChildOwnerDele gator. BeanContextProxv , 
BeapContextServicesOwn etPelegatof. CJjpbpacdILIser. PataltemSink . Ima geQbserver . Men uConta iner. 
Serializable. StateSavablc. OlBean 



public class Con ten tin foBean 
extends Pataltem $inkU IBea n 
implements ClipboardUser 

The ContentlnfoBean class is a visual component that displays the contents of a raw data item. If no contents are 
available, it defaults to a split pane containing the JAP menu and the PropertySheet of the raw data item. The contents 
may have be multipart, and may be text, html, rich text, or an image. Multimedia support will soon be added. 

Author: ■ 

Jaime Garcia, Polexis, Inc. 
See Also: 

Serialized. Form 



Inner classes inherited from class javax.svying. JPan el 

jpap^?, fl Aeee ? 3jLbj t eJPanel 



Inner classes inherited from class jav ax.s wing JCmpxiient 
JCQmoon&nt . Access ibleJCoraponent: 



Inner classes inherited from class java.aivt, Contain er 
cppt;a^g.Rcee93|bl^Awycont;a,ipec 
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Inner classes inherittd from class iava.awt. Component 



Field Summary 




RESOURCES 




localized resources fbr this view object. 



Fields inherited from class com.xtt.tti. Ab3tractUlBean 
ujlbeartliatencfi 



FUWs inherited from class javnx.swingj£^£jn.pj>ncnt 



^eeqasib^oqt.^^ J^er^ rLyfl t, TOOL TIP _TEXT Jttp. ui, QN 0SriWS0_CON OIT%QN« 



Fitiiir inherited from class java j» wt.£flp}ppo.en| 

SOT^Pj!J^L^g«tf6NI, £FWTE^_ALiq^2lSHI t lim^&UgMgijl/ RIGKT_A C«IGHHENT , TOP^frSgNMENT 



2m elds inherited from interface iava-awtimagc lmagcObjerver 



WAX. &UflXX& U. frWEBlT3> BfiXSttX. ERPFEBTIES", 5QMSBETS . WIDTH 



Constructor Summary 

Co-ate nil a/ oBqan ( ) 

Default constructor that creaies in empty ContentlntbBean. 



Method Summary 




addRawQ&taXt:ea{Ob1sct cewDateltemt 

Load the raw data item into the Content! nfoBean. 




^cidJlay 3 ^ta^te^s { Object ( 1 rawDataltemsJ 

Add the raw data items in the array. f 


boolean 


canClearO / 

Return true if the ConteritlnfoBean has an object and it is selected 


boolean 


eanCloar (Ob-teetM iteaw) 

Return true if the specified items can be cleared 


boolean 


cariC.ap* O 

Return true if the Content Info Bean has an object and It is selected 


beoioin 


canCopvtQblect n itex.3) 

Return true if the specified items can be copied. 


boolean 


canCut 1 ) 

Return true if the GmtemlnfbBean has an object and it is selected 


boolean 


eanCut lOblect (1 items) 

Return true if the specified items can be cut 


scolcan 


canPaateO 

Return true if ihe Con tent InfoB can can paste new objects, false >f noi 




eanSalQjrtAiit) 

Return true if the ContentlnfoBean can select all objects. 
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Tiffin % a 



boots lfl 


canaBABcmona \ j 

Renun true if the Ccntentlnfb'Bean can un*seleet all objects. 


void 


clear <) 

Notify the ContentlnfoBcan to remove the current raw data item only if it is selected. 


void 


clear (Qb-l gct; ( i itema) 

Glean the given items. 


*old 


Removes the currently loaded object. 


boolaui 


contains t Obi eccf] i tenia) 

Rsrum true if this CcnteatlnfoBean contains ail the objects of the given array. 


boo loan 


coftta±n3Co*&ponent.t Component component) 

Check If thr given component is contained by this InfoBeon 


void 


cpp^cciittaid clipboard) 

Called to invoke thb Co ntentln to Bean's copy* action, which is to copy all selected data 
to the Clipboard. . 


void 


copYtSUpfcMKt clipboard, Q&U££U items 1 
Copies the given items into the Clipboard. 


. prot acted void 


cteateContentO 

Method called when there is no content to display for a raw data Hem. 


voic 


c*t< pinboard clipboard) . • 

Cut selected items from the ContentlnfoBean and post- them into Clipboard. 


void 


cut (Clipboard clipboard, Obiact f } itsns) 

Cut the given, items from the ContentlnfoBcan and post them- into the given Clipboard . 
only it they occur m the CantentlnfaBean. 


protect ed .cs-nsakret 


<T» tCon t&inar«o rContent < int index) 

Oct a container with the contents of the content object at the given index, or null if the 
content type U not supported. 




9*tContonts () 

Fetch the currectly loaded raw data item 








Cet the JAFAndPraperty component used by the ContentlnfoBean to display the 
contents for raw data items that have nothing else to display. , 




o*« tl>«.L5D&^AXb*x£4*nu ( LaifDatal tam dataltaia. hoolean ahowCutPaat el tergal 

Return the data item menu for a LeifDatalttm (usuallv the selected LeifDataltcm). * 




Return die ReaourceBundle for this ContentlnfoBean. 




ge_tSelectadCtojec^a { | 

Get an array of selected objects. 


void 


in£oMode 1 Changed U 

Messaged to indicate an LnfcModel change for this InfoBean or one or mere of its 
LeifDaialterns. 


bcoJein 


isCreatlngCoaten^ t ) 

Check whether default content creation is set 


bcole»n 


icDr agtrvaJblodi ) 

Return true if the default Drag support Is enabled 


coolvan 


^ProffSnabiciiO 

Return true if the default Drop support is enabled. 
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Check the selected state of tfie content object, if there is currently one loaded. 


boolean 


LaXISNctifyingl) 

Check whether the ContentlnfbBean is updating based on XIS events and is notilvin- 
XIS of rav* data Item attribute changes • 


rote 


State (QUflfaQfltft clipboardl • 
Paste the data Objects from the given clipboard.- 


'Old 


removBAJURawDatal tea* | ) 

Remove all of the raw data items that are currently loaded 


void 


regvovagUtwOabaltca (Object rawQatal tem> 

Remove the given ravr data item if it is the currently loaded raw data item 


void 


'rogiovs^UwD.ataltaa^ (Obpcc^ I ] rawOata I teas) 
Remote the raw data iterr-s in the array. 


void 


SQiSSJAii | ) 

Set the selection state of the object to true. 


void 


aelectMon« {) 

Set the selection state of the object to false. 


void 


setCreateCpn tent (boolean create) 

Set whether content should be created for objects that do not have any disputable 
content, via a JAFAndPropertyComponent. | 


.void 


««tOsa.g£nablad{ boo lean anabledrag) 

' Set the status of the default Drag support. 


void 


aetDra^jOvneffEroxvfQraoCfcrner draaProxy) 
Set a DragOwner "proxy" for this InFpBean. 


void 


so tDrop3nai3led( boolean enabiedcoo) 
Set the status of the default Drop support 


•void 


aetDror>OwnerProxv ( DronO-mer drooProxvl . 

Set a DropOwner -proxy" for this [nfoBean. * - 


■ void 


aetSelect.ioa (boolean selected) 

Set the selection state of the content object 


void 


satllSiJotifying (boolean notify} 

Set whether the Con tentlnfa Bean should update based bn XIS event* and should notify 
XIS of raw data item attribnte changes 



Method! inherited from elasi com,xbJcif.mfobeflni. PataltemSinkLngenn 



addoAFPopulator , addRawPatalfcemaA.aGeouD . add5ervi.ee , cloac . 
craatesaanconcextservicesovnercglecator . OiSSSas, gsC8gar)C,Qnt,e.)<tPcpKV, 
qetBeacContextServices , Qg£lD£3*te&&X. ggt JAFPopu/Utors, 

qettgiffafcaUffiflanu.. igflUfli£tot;aSt;en«tetM, cfflfcLq^oanaltgrnMenH* gftSMenuBac, 

CQtOwngdBeflnContextOiild. <TetServj,ce, gofegggyice, gafcporvi.c*, gatSbafriaBaca, aetfloplBara, 
flfitfila, ln |r.ializgBqanCentaxtRq3Gur;;a3 , Lpi.^alizaBaanContextSBrvicea^ 
InvalldaceTnfoModel . IsProoPasteEnabl&d , isHandlingC lloboardOperatlons. 
• ^easfiBe^ rrftnraHrRPsmirrp^. fp i eAaflflaanCflD£axtS&£zj c a ■ rftvnXRAnrtiorftClH a lagprovt rter, 

ravcKBPran aProvidar. ravokaSgrvtea. secDrooPaaeeEnafalad. a 9t Kandi ln«TCl Ipbffa rriQpa.rag lOHS. . 
va lido tePcRdincSeteganggn tent 



Methods inherited from class com jcis.plAbstr actUl Bean 

add UiaeanLia tense , finalize . petShortT .U I.e. n etTitla , catOlComoonants. U&sajve., 
ISSOaafiCi, iS_£lfi25fiB, ptpcsssurBeanEvenfc, ceinDyaoyBe^Utgn^ri ca?t;Qre5tflpe,, sareStatj, 
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Ida 



Methods inherited from class hvm.5wlhg. JP a q el 



CBtACCa s stbleCQntfiXt , fleiPrCUsstP, ParamSfcrlna. uodataUI 



iYIeihod5 inherited from class java rawing. i£ojnpjmejit 



adQVjWaft^QjftnqftLj,ff^n> , ^ qoaauWiath^toet, cont, fl ina, crcateTpolTlo . diaable. gjoaEdfi, 



gjUeftope^vChanqa, 



fJLregrooer cvaiance . 



firePrope rtvChanae , 



U&aXSSBSX&SbS&a&T ffiraProoertvChar.aa. tUa£lga&£t^m fl&. 
(iCflVfitQafrlaChangg, QecAgtiori rorKavStgcfea . qatActionHap . 

qfitAuEoacroU? , qasBordec, assasundj. octcli-ntProT^ rr, y 
qspCeyyonHn^gaphAqa t <TC tCffPd U*ffPf fl* K« Ytt > QatDetauaGr aohlcsOctlons . cetGraphyc^ . 
SSiaifiialil, qstjnpytfop , Sfiiln£ULM5> catlnautVerifiar. qsttnaeta . oetlnagfcsT 

gatuauoaxg * t aaJU flcaUaa * qfisttfl*imwnsi;e, aetttinimumSisft. oetNextrocuaabuconmon.^ r 

qetPregBrrgdS iZ S > CfttRPffUtBrfldK&YStroKM, OatRsotPana. qatSlza . qafcTcolTipLocation 



p£30aktelsfias& > qatwidth. getjs, SSSlr ocabrocua. tiasrocus . isPmihipRnf r fli r pH 

IsFpqus^yeteRyi; , AqEgpuaTzaveraable, j fl L i qht; qh tComp went , laMnn*fl inn Phnw 
^M^.lt"W^is^5^q. lsHlfUratmSigflSat . iaOoamia . i3Q P tiraizedDcauinn£r.ahl« rf. iaPaintintrTn a 
iaPrRfffryBdSiieSfit> isRamiaat FacusEnabled . IsValldateRoofc . paint . oaintBcrder . 
BAlfl£gbUA£afl i a&ia&SagBgBgJlfc * ttflJLaUmaffiaia^LUr oalnt Immediately, print , print All . 
ftCiQ£fig££|fi£« printCqlld W t RgljiccorappneM , P^MgQ0Ppon?nfcKeVl5»gn.t , PtoeM3Fccu 3 R W n^ ■ 

r e g 1 s t e rKe vboa rtAcr 1 qp . regi s tegSgybQardAgtioa . . raraovaAftcaafcorListanay rgmoveNotify . 

TT^moyaPgQCert;YCt)^nqgLAgCqn9y> r groove Pr oper tvCharKtat tat oner , rerroy eVe toa b leCha nq c LI a t;t»nt» r f 
XSfiiiatf gepa i nL * remieatDgfatil rroqjifl . request Poois . rasetfCaypoardActions . reshape . 
re^l^e , gc rDURgCCTWgiftl^ , SBCflCtlQlMan. gOtMi<niMnEX, pa^Ugquwn tYr 
,aetA^oacyqj,^q, je^aaeKSKSiffill , geEBOgflBg* 5et6epuoG rgphlc30pr.lan« . sat Doubl oBu f £o red . ■ 
5aL£naiifid. aalEaot, 3efcrorgq ? pynd, 3Q*tattUtMaP, setlnoutVerlf Ur . satMaxlmanSlza . 
sfltHjqwmSizq, aetNcKtrpo^ablBComoonent . jetQpaouc . aetPreCerr adS^zg. 

gftt^OTSfftrpgMaenab^^ , a.e.cToplTi.pT^c r gfitjjl, aetverlf vlnputwhgnFta^Tp^fff;. aetvislbln . 
un c e 3 i a te rKe vbaa rdAct lph, update 



Methods inherited from dm fava,aivt.Q)nlainer 



adfl, add , add, add, add , adacont 
do Layout . findCo ntPorientA^ t, 

g tComao 

Jilt, iiajt, ificifee, mlniaumgiqe, paipt^ptnporjer^a, , pre £c read ? i^ei p rlntCcmponents . 
B£afi«ggpntajngfgy^t;, procea^Svant;, remove , remove, gewOYcAll . rewQye ContainarLlatffngr. 
setfrayout;, VftUtifl&fl. ralldateTrgg " """"" 



JSL£LA5I£0SJC r addlmpl . COunt:CoinDonanr.s . ■ dgli.v > erEvor\ ^; r 
aBfcfcMaaU&j la^t;?, kJag&liriA&e,, IsAncaatorOf . layout* 



Methods inherited frnrn dasa j a viuwt Component 



id^ f fl&lggfl R p.nf n, ^ ul.areri.e r j ftgdJESss.ttaMatener^ addHlerarchvBounclaLiacftnpr. 
addHi^ra rchvListener . addlnputHefchodLiatane r; . addKevLiatgRer . addMouseLi<tgng r. 
a{m?H39WgtfcqnL^t«Hflg > iifittadA, ChegkXraqer ff^epktiftag £# cgaloac+Evanta . contains -, 
gffeatel^ga, S£aa£aIaaaS, ^isablaEvopts , dispatehEvent . enable . ehableEv^nta . 
flpq^ J ppMtH e ^hod a, qnPackqspupd, WWVWdS* fl.fi t<l9^gg^QdB^ qe tCopaoneneOrienta fcion . 
ggtCHgaor , qe»;DropTaraet; t qetront;, tt etfontMetdcs , • cat Foreground, 
■qegCraphjcaqgf\f jqq rat^og L qe^tnput;Conqg^t;, oeClnputHethodflQqu^st^ . QefcLocale. 

*SL* qq^Nama, gatPagant , gatBaar . aetSiza . ^jatToolkib . 
qg^T««tf tac3c> qo^r<?<^a t h^n^IeSvgng/ image Update, inside .' iapiaplavable . i^a ble4 f 
J,jLi.qh<;wq^qt; t , U&$XVAlB&» LsYfllid. XaVjgAfalft* tceyOq vq. kavUp . list , list , list , 'location . 
UafcEasagf mouagDown. mouse Dran. raouseSntgr . mouaggxit . mQuseHave , mouseUo . niovq . 
r^eKt;foqv3 r BftifltAU> 22iL£l£Hl, QfepaggIfflagR> pre oarelraaae . pr pcea scomponantEvanr . 
orocft5cHio|rar^Yfimmrfaer>rtt , p r oceaaH i a ca rch, vE vent . procftaalr.pu tMethodSvcnt . 



ceratrre. renoveCompon antLlstener . rerwjverQcuaLla tener . 
raoundaLiatgner , rernova H 1 e ra cchyL i 3 1 ene r , reraovelaputHethodListgngr , 

»siss r .rjasisa, £q;Eovtrid3, ao&Saaada, aetCompenentOgientatioti. aatCurao^ . 

aetLocole, 3et;Locaqipn, aetLocat^on. setName . aetSlie . aetSizq , ahov . 



SLiiaw. Size, tost c inq, tranjferrpcug 
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MsUcris inherited from cb « iava.lanc. Obicct 

SififlS. fiflM&Ia.- Sg£CU33, haahCode, poyjLl' flaSijvAUr «ai&» wait, v ait 
Mctfcoda inherited from Interface cqnLxb.uUClipboardUsgr 

Methods Inherited front interface cam.xis.uLUl 8m o 

addPro n* gfcyCha nae Jtls.aaner > removaPropg rt vCh ane aList ana r 

Fietd Detail 

RESOURCES 

public static final rvpgdReaoiireeBiindle R2S0ORCSS 
losilized resources for thii view objea. 

Constructor Detail 

ContenflnfoBean 

public Contantl-if a3«aj\( > 

Default eonatrjctor that crcatcj en empty CoolentJnfoBean. 

Method Detail 

. gctContenta 

public Object s»tCoot»»!Ls ( > 

fetch the cuifectly loaded raw data Item 
Returns: 

the currently loaded object, or null if no object is loaded 
setXISNotifying 

public void actxlSHozifyiagf boolean notify) 

Set whether the CoMentfnfoSean should update bastd on X1S events and should notify XIS of raw data item 

ittribute chaagts 

Piramelers: 

notify -if true then notify XIS, dse do not . 
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. bXISNodfylng 

public boolean isXISHotifyLngf) 

Check whether the CoftientlnfoBean it updating bised on XIS 9 vents and b notifying X1S of raw da& item 
attribute changu 

Returns: . 
true if it b notifying XIS, else feUe 



remov e AiLRawD ataltenu 

public void ramov*XJOJlarwDAta.ItoiM 0 

Remove ail of the raw data kenu thai are currently. loaded 

I, i n nr , ^ . — i ■ Cu 

gctRuDurccs 

public Typ edfleaoucceDundle setftoaouxcMi) 

R£tum the EesoucceBundle for this content infoSa an.. 
Overrides: 

aetaoaouccLea in ckss DataltemSinkUIBean 

Returns: 

the itaticaliy sourced ResnurceBundle. 



xnfoModelChanged 

public vbicl ir^oModaLCharige<lt) 

Messaged to Indicate an InfoModel change far this InfoBean or one ot more of Its LelfDatal terns. This should 

reload all currently baded dtta items to pick up UfoModc! changes. 

Overrides; 

Lnrfigiodeicnangec in class narftlCfmSiintfJiafifln 



addRawDataltems 

public void ad<i5iawO*taEt«i* (Obifi£i(] ravOataltsm*) 

Add the raw dota items in the amy. Will only add if the array hae only on* object and the object is not the 
currently loaded rawDaUltera, 

Parameters: * 
cawOetalcema - the array of objects to be added 



addRawDatnltem 



public void idd5LavfJataIhAA{DbiaCt rawDa taltsrr.} ' 
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Load the raw data item into the ContentfnfoBefin. If the raw data iteta -supports the ContcntDomain and has ■ 
content of type that is currently supported then it wili be displayed. Otherwise, if content creation U set to true then 
default content will be created, using a J AFAndProperryComponent 
Overrides: 

addftawoat^tgs'in class Qa^^inWj.ia^ 
Parameters: 

rawDaeaiteaj • the raw object to display . 



createContenfc 

protected void croataCantantO 

Method called when there is no content to display Tor a raw data item. The default behavior displays a ; 
JAFAndPropertyComponent of the object, but subclasses may wish to display something elso instead. 



. isCreaHngContent 

public boolean iaCre.afcim3C0nfc.eat ( I 

Chetk;whetacr defimll content creation is set If so then a JAFAndPropertyCcraponent will be created for items 
that have no displayable content. 
.' Returns: 

true if default content is created, else felse 



setCreateContcnt 

* public void so tCraateCoatent {boolean create) 

Set whether content should be created for objects !hat do Dot have any displavable content, via a 
JAFAndPropertyCompoacnt. 

Parameters: » 
create - if true, create content, else do not 



remov eRa wD a taltems 

public void ff a»ovaR*wO aital tww ( Cb i set 1 1 rawCataltecw) 

Remove the raw data items in the array. Will only remove the object that is currcntby loaded ifit is contained in the ' 
array 

Parameters: 

cawDa tal terns - the array of objects to be removed 



rcmoveRawD ataltera 

public void resuaveftavDatalteffl (Object cawDataltem) 
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Remove the given raw data item if it is the currenti j loaded raw data item 
Overrides; 

££Qfm£aH&d£A Itsa in claw QAJ^it^-i^io feUia&An 
Parameters: 

ravpatiltom-EhR object to remove . 



get J AF And P rop e rtyCo m pon en t 

. public JAEAEdEggpg 5 c vCosTponanc gouiArAndJrcpertycoaiporicnt I) 

Get the JAFAndPropcrty component used by the C ontc n tin fb Bean to display the contents for raw data kerns thai 

have nothing else to display 

Returns: 

the current J AFAndProperty Component being used 



gelContainerForContent 

protected Consaiftor ga V=o a fcxino*r© *Co niwit ( int iada*) 

Get a container with the conunts of the content object 'at the given index, or auil if the content type ta not 

Supported. Subclass tots If you need support for a type that is nol already supported. 

Parameters: 

Index -'die index of in the object 
Retorts: 

a Container with the contents at the given index 



getSelectedObJects . .. 

•puCiic QtlfiCtn getSaiectedObjectaO • 

Get an array of selected objects. This will return an empty array if there are no sheeted objects. If the ravr dita 

kern b selected it will return mi array of aize I with 5he raw data item inside - ' 

Returns; 

ati array of selected otyects . 



isSelecjted 

public boolean iaSelootad () ■ 

Check the selected state of Che content object, if there is currently one loaded. If there is none, return false. 
Returns: 

true if there U an cbjeet and it it selected 



selectAil 

public void selaccAlK) 
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Set the selection state of the object to true. 
Sptciffed by: 

aslBEt&U in interface aipfrqagtiUssr 
Overrides: 

ssIscjcaU in class mai&gaginfrUjaeari 



selectiNone 

public VDid selectSonoU 

Set the selecn'on state of the object to false, 



setSelection. 

public void setSelection (boolean selected) 

Set the selection slate of. the content object 
Parameters: 

Che -new selection state 



canClear 

public boolean canClear O • 

Return true If the ContentlnfoBean has an object and it is selected 
Specified by: 

canCUay in interface ClipboerdUser 
Overrides: 

canClaac in class Da fca 1 1 gmSin bU IBoan 
Returns: 

true if the raw data item is selected 
See Abo: 



canOear 

public boolean canCleax ( Object CI items) 

Return true if the specified items can be cleared. If the item is not in the ContentlnfoBean return false. If there is 
more than on« item return false. 
Specified by: ; 

canClear in interface ClipboardUa&r 
Overrides: 

canCloay in das* Pa^altemSinkUIBaan 
Parameter*: 

itecLs - the Array of items to be cuL 
-Returns: 

true if-ali of the items are present, otherwise false. 
" Set Also: 
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cant* Lr.3 ;Ob j sc^ 1 1 1 



canCopy 

public boolean cauCupyt) 

Hetum true if the ContentlnfoBean has an object and it is selected 
Specified by: 

c anCopy m interface CUpboardOaer • 
Overrides: . 

S&aSaax in clay Partem? MrtPEBean 
Returns: 

true if the raw data Item Is selected 
5ee Also: 

car.Cl&artj 



cahCopy 

public boolean canCopy [ Obi act [ ] lterasf 

Return true if the specified items can be copied. If the item is not in the ComeatlnibBeaa return false. If there is 
more than one item return false. 
Specified by: 

gjancooy bi Interface ciioboarduaer 
Overrides: . 

sajiggay ui class pa^3j;^sinKtjis^ftn 

Parameters: 

items - the Array of items to be cut 
Returns: 

true if all of. the items are present, otherwise fabc. 
See Also: 



canCut '» 

public boolean eanCutU 

-Return true if the ContentlnfoBezn has an object and it is selected 
Specified by; 

canCut in interface diaboardUser • 
Overrides: 

c^iiCut in class Patalten^JMISgan 

Returns: 

true if the raw data ttsm is sciscted 
Set Also: 

cancieari) 



canCut 



public boolean canCut (Object; n i tarns J 
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Return true ifthe specified items can be cut. If the Itsir. Is not In the ContenilnfoBean return false, tfthsre is more 
ttean one ite in return false. 
Specified by; 

tuacuj; in interface ciipfcoiuoJflaej- 
Overrides: . 

cancuc In class DataItemSlnkUI3ean 
Parameters: 

itema - die Asrny of items to be cut. 
Returns: . t 

true if all of the items are present, otherwise false. 
See Also: 



canPaste 

public beoXeen can9«.stA() 

Return true if the Cootemlnfc-Bean can paste new objects, false if not. 
Specified by: 

eanPaate in interface Cl^oha&rdDaar 
Overrides: 

saagftass inclasa t QatflH;eff3lnMI8fifti; 

Retarxu: 

defeult is always true for the Contcntinfo3ean. 



canSclectAll 

public boolean canSelftctAll [ ) 

ilcTum true if the. Contend nfoBean can select all objects. 
Specified by: 

canSalcccAU i« rnterface gjiobQ^^yg^r 
Overrides: . 

«fiSUa&&&U & class p3tay;emsip t wiBfear t 
Returns: 

returns true if there b on object end it is not aelccted 



canSelectNone 

public boolean canSelectfifone ( J 

J Return true if the ContcntinfoBcan can un-select all objects. 
Returns; 

returns m* If tne raw data Item ts selected 



clear ■ 



pubLic void el«ax{)' 
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Notify the ContentlnfoBean to remove the current ravr data item only If it Is selected. 
Specified by: 

cle&£ Li interface SligSaastoai 
" OVerrides: 

eie_ar m claw £l*f^£jW5SiflSffJCftfifln 



clear 

public void clear fS&lSSit) itena} 

Clears the given items. These items only get cleared if they actually occur in the ContsntlnfbBean. 
Specified by: 

. interface a.iBfeoasdUssj ' 

Overrides: 

glSAJC In class PataUfflnSlnKVEBft&a . 
Parameters: 

• iceas - the items to cleared. 



ciearAU 

public ttoW cle»*MLO 

. Removes the currently loaded object. 



.copy 

public void copy I Clipboard clipboard) 

Called to invoke this CoritentlnfoBeao's copy action, which is to copy all selected data to the Clipboard 
Specified by; . 

COPY in interface c llpbcardUser 
Overrides: . ' 

copy in class PatalteraSlrtkaiBqan 
Parameters:. 

clipboard - the Clipboard object that gcti posted to. The actual Items posted arc contained to a 
LeilTransferable. 



copy 

pubUc void copy t C lipboard clipboard, . 

Ob-toct n items) 

Copies the given items into the Clipboard.. 
-Specified by:', 

copy in interface c^ipboardUaer 
Overrides! 

copy in ciaas Oe tar teas inkUIBe aa 
Parameters: 

clipboa rd - the Clipboard object that gets posted'to. The actual hems posted are contained in a 
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LctfTransfemble. 

itens • the array ofObjtcl items to copied. 



cut 

public void cut (Clipboard clipboard) * 

Cut selected items from the Con tentinfa Bean and post them into Clipboard. 
Specified by: 

cut; in interface clioboaniUaar 
' Override!: 

cju.e. in class Pat* I t«jng_l nIsOXaean 
Paramatsrs: 

clipboard • the Clipboard object that sets posted tb. The actual items posted arc CDnteined in a 
LeifTransfcrable, 



cut . 

DU&Uc to'id cat ( Clipboard clipboard, . 

QfclftCtn i certs) 

Cut the given items from the ContentlnfoBean and post them into the given Clipboard only if they occur in the 
ConteotlnfoBean. . 
- Specified by: 

cut in interface C;lipbo*rdUaar 
Overrides: 

Parameters: 

clipboard - the Clipboard object -hat gets posted to-The actual items posted are contained in a 
LeifTransferabie. 

Items - the array of Object items to cut and posted. 



paste 

public Moid paataC Clipboard clipboard) 

Putt the data Objects from tie given clipboard. This retrieves the clipboard contents and does t sire pis add 
Specified by: 

2ia£ft in interface cllntaoardQser 
Overrides; 

Parameters* 

clipboard - the Clipboard that contains the objects. 
Stt Alio; 

a.fci=mwOata I tema (Obj ec.tJ U 



- contains 



• public final boolean contains 1 1 items \ 
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Return true if this ContentlnfoBean contains ait the objects of the given array. 
Parameters! 

items • an array of objects to locate in the Content! nfo Bean. 
Returns; 

true If there is only one object and tt Is confined. raise otherwise 



con ta insComponen t 

public boolean contalxvaCompon<mfc ( Component component I 

' Check if thr given component is contained by this tnfoBean 
Parameterj; 

component - the Component to check for 
Returns: 

true If It is contained, else false 



getLeifDataltemMemj' ■ . • 

public JHenu q«tL«l£DataltcmMftaa( Lalf Oatalcem dataltara, 

boolean ahawCutPastelteas) 

Return the data item menu for a LeifDataJtemXusuaJjy the setectei LeifDataltem). this is used by ihe ttenubar to 
add mcnuitcms from this JMenu to a Data menu ir there is exactly ene DataltcmSeiccted selected. 
Overrides: 

9 e , { :, i»g i g Da t . a I ?mfl e au, in class Pa^alteiRSlnky^Ssan 
Parameters:-. 

data item - the LeifDatallem to get the menu for 

shovCut Paste I tacis - true to albw cut and paste items to appear, false to omit them. 
Retards: 

the JMenu for the given LeffDataltem 



uDragEoabled 

public boolean isDragSnabledU 

Return true if the default Ores support is enabled. 
Overrides: 

iaoraqgnafaled in clasi PafcmgpSlnhUXBean 
Returns: , 

true if drag is enabled, false if not, default Is Initialized to true. - 



sctDragEnabled 

.public void setDraggnabled (boolean enabledragj 

Set the stains of the default Drag support 
Overrides: w 

sptDraaEnabled in class QatfiltemSintiKBBan 
Parameters: 
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anablaorag * true If defeult drag support-should be used, false If not. 



setDragOvvnerProry 

public void sotDraaOwftacffrQ>ev ( DraoOvnar dragProxy) 

Set a DragOwner "proxy* for this Info Bean. 
Orcrrides: 

agnOCAaOwnarggcixv In class Pacalf *3lnkHTpft* n 
Parameter!: 

dragFroxy - a DcagOwner implementation. 



isDropEqabled 

public boolean isDrep£A4kbi«d { ) 

• Return true if ibe default Drop support U enabled 
Overrides;. 

lSPrOCSnafaiftd In Class DataIt«mBinfc01B.«n 
Returns: 

true if drag is enabled, feise if not, default is initialized to true. • 



setBrop Enabled 

public void sefcfiropE&ableci (boolean enabledrop) • 

Setmeststo of the default Drop support. 
Overrides: 

flgtPfqffBPflbJL^ in claw a afcfllteaulinfcoiBcan . 
• Parameters: 

anabledrop - sua if default drag support ihcuid be used, false if net. 

< • ■ ^ 5- 

ic tD rop Ott n erP roxy 

public void ag tox opQ wnerProxy ( P r opcwng c dropproxy) 

Set a DropOwner 'proxy" for this InfoBean. 
Overrides 

Parameters: ^ 

dropProxy - a DropOwner im piemen tat ic n. 
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Package com.xis.leif.ini 

This package contains classes that provide the APb for using information management in applications. 
See: 

Description 



Interface Summary 


Attrfpufe 


The Attribute class represents an attribute for a particular data type. 


AtlributeAlias 


The JUtributeAIias indicates an alias from L.n Attributes to a Single Attribute, together 
with a precision level; the higher the precision, the better the alias. 


<4frritWtefucrorx 


The At tribute Factory class allows an implementor to return an appropriate Attribute for 
the given LeifDataltern. 




The AttributeLookup interface is used to lookup Attribute objects for a particular data 
item. 




The OisplayLabel Interface defines methods that are needed for use with 
DisptayLabeiAttributes. 


Domain 


This interface describes the basic Fields and methods possessed by all Domains. 


InfoModel 


The InfoModel interface is the interface that is used to convert raw data items into 
LeifDatal terns. " - . 


LdfDatttltw 


The LeifDataltern interface represents a simple data item 




This class is used for observering a LeifDataltern to know when it has finished processing an 
action. 


LUzDmltm 


The Lite Data item interface represents a data item. 




If a PropcttyProvider implementation is added to services it can be used to replace the 
standard behavior when a PropertySheetView is opened from a JAF menu or as a default 
command. 


RawDutnltemLooknp 


The RauOataltemLookup interface is used to look up a raw data item from a unique id. 



Class Summary 


AbstractAttribute 


The AbstractAttribute class represents an Attribute. 


AttributeAliasPluggnbleService 


This register Attribute Aliases. 


AttributeDescriptor 


The AttributeDescciptor class is used to describe an 
attribute without providing functionality of how to use the 
attribute. 


AttributeDescriptorFactorv 


The AttcibuteDeacriptor Factory class is a singleton 
class used to create or get ALtributQOe^ipiass. 


^tlrl5Jiie£3 ciflrxlafoM sclslSuljsei 


The AttrtbuteFactorylnfoModelSubset class 
provides an InfoModel that will add the Attributes specified 
by the AttributeFactories to all LeifDataltems mis 
InfoModel creates. 
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Allribu'eCetReg ue5t 


Th: Act clouteGe.tRequest class is used to package all 
the necessary parameters for getting, the value an ittribuce. 


Atir1baieL^i$J*e.g,ue.i! 


The Att eitjiicel.ee fcp.aquast class- bundles attribute! 
neeced lo gain access to foefcoc" LoiCDatal terns. ■ 




The Ate elbutes is a container for holding anrlbutes. 




The AtcrUucesecRequese class is used 03 package all 
the necessary parameters for setting an attribute. 


gasej>atajlerji 


The aasaca.tai tare is the first wrapper around raw data ' 
items. 


Base Info fetodel 


//PENDrNG(RK): Any method marked with "PENDrNG" in 
the JavaDoc wtil //liicery he removed bafore XIS a released , 
in final form. 


. 3qje?nroMgd«?^fh'};^frpv|dtr 


The BaselnfoModelsexvicesProvlder clasj will- 
provide ail the services svai lable trom the BaselofaModel - 
to the given BeanConuxtServUe* object. 




This dajs populates MFMenus for generic collections. 




The DatalttwnActionMenager class provides some useful 
static methods for dealing with actions on Lei fData Items. 


fiMqUicniAcUonManaggr.LctfRctercnccAalgnLUtcntr 


Tbls class is an actionLinener to be.used with 
LeifReference "Load" tnenus. 






The OetaltenMenuSet class is used by the - 
LeiflAFUnUtles class to return essentially a DataUem 
popup menu with annotation. 




The Data 2 teaManuSGC. Entry class encapsulates a 
Dataltem and it's menu, and also provides some 
convenience methods for adding additional menu items. 


De fa ultWrappcrAt tribute 


The DefaultwcepperAtcrifcuce dass is a generic 
attribute that is the superclass of all defaults in generated 
domain attributes. 


Dbp lav Lahel Attribute 


The QisplayLabelAccribute class is used to cfispUy 
one or more Attribute values in conduction with string 
literals specified by users. 




The GispiayLabelOata ciass b used by the 
OlsplayLabel&t e r ibuto to Store » ntappingcf 
Lei fDatal terns to DisplayLabelTcmplaics. 




The DispiayLabelTsaiplate class is used by the 
DisplayLabalAt tribute to compute and store editing 
and rendering values for every LeifDataltem that has the 
attribute. 


DamainMethod 


Abstractly represents a'Dcraain Method. 


Ocjrtta m M c thod DcacrtD to r 


The Oamaintfet nod Descriptor class is used to describe 
aDornainMchod. 


DojnalnJVlejjiod Descrip tpjFaclo ty 


The Oetfna irttle t hod Desccipeo* Factory class is a 
singleton cfess used to create or get 
Qonainfte i hQUQs a cr a a t o rs - 


DomamWrapner 


This class adds methods to Lei fDatai tern d< legator that are 
useful in the domain wrappers. 


PynamipA^ributej 


The DynaroieAt tributes class is used for storing - 
dynamic attribute*. 
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Field MeiaData specifies sorting and subset criteria for an 
attribute. 




The eieldMataOacas class represent* a collection of 
FieldMetaData for a data item. 


InfoModdDataltctn 


The rnCoHodaiOataltcra allow* views to wrap 
LcifDntaltcms and odd/rcmovc/rnodify attributes that will 
only affect that view. 


InloryiodeiSuPset 


Typically when creating an InfoModei to nest within an 
existing InfbModel, which is done byvjewUtBeans, an 
InfoModelSubset is used 


tnralidWrap per A tt.rjlt11.t5 


The InvaUdWrapper Attribute doss 


L«fD*taIt«mComoarator 


The LeifDaialtemComparator compares Lei fDatal terns by 
AttributeDescriptor supplied by the user. 


LeffDataltemDeltPator 


Implements the methods in LetfDataltem in a wrapper so 
you oWthavc to. 


LejXDaJaJt*;ri5oj3er 


The LeifDataltemSorter provides a default sorting tool for 
all LHIF LeifDataltem objects. 


teifDitartcmUpdate 


This classes is used with the LeifDataltemObserver. 


Ldflmtializatfoii 


The LeifininaUzmion class handles some standard 
initialization for most X1S Appftcadons. 


IddtiAZULIBflg 


The L»if JAFUtiiLbio* class provides some useful static 
methods for LEIF-relaicd JavaBeans Activation Framework 
(JAF) processing. 




This class is on actio nListener to be used with 
Lei {Reference "Load" menus. 


LeifRequest 


The ie if Request class is used to package all the 
necessary parameters for requesting information for o 
LcifDataltem. 




The Leif Transact ion class is used to construct a 
transaction. 


k°e* ?d ^eifDatnlte m 


The LocksdLeifOaCaCtera class Is used to enable locking 
on the data item. 




The Me ztuxiReques t class is used to package all the 
necessary parameters for invoicing a DorraioMetbod for a ' 
LeifDataltem. 




Mutable subclass of fsttri.buteOc3crl.ptor. 




This class provides useml support for using the 
Lei fData (temOhserver. 


RequMtPool . 


The &e quesa t Pcol class is used to assist Object pooling. • 


Rca partes 


The Re jouicco class 11 automatically generated end must 
be public, but it is intended to be used only by Java's 
internationalization support classes. 


Selectable Data [tern 


Creates a wrapper around a LeifDataltem for a 
SdectablelnfoMcdel. 


SelectablelnfaModcl 


Msnages selections for the selectable teifdata items that are 
contained within this model. 


Tram! a tor 


A major design jdal for XI S was to provide the ability to 
integrate existing data item classes without modifying them. 
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fj^uMy ISSN? 





Provides a central location for maintain big Translators, 
extended Translators and beating Domain methods on data 
items. 




The UndefLnadAe tribute class represents aa undefined 
attributes. 






The visibLiityAtcribsica class is an Attribute that is 
ready to use for LeifDataJtem visibility. 



Exception Summary 


n!ita!fpmNntFounqEitephoo - 


The Datai t«mflotrourtd£x caption claxs is an exception that can be thrown 
when trying to look up a data item from an id 




Signals that there wis a problem with the creation or modification of an 
ObjeciSchenw. 


Traqflator^x;«Dt|fln 


Tho Translators* caption class 




Indicates that the requested attribute alias could not be calculated or convened 


V a d e fi ncd Le Jf A tl Hbo te Erce p Ho a 


Indicates -that the requested attribute is not applicable for the object. 


V adc fi r»*d LelfM a thod E t ceptlon 


The UndeflnedLelfMethDdCxceptlon class Indicates that the data item dose not 
define the method. 


Uar«niovablcAtt_rlhiitcExctpiron 


The UrLxmo v a blc A ttr bate Exception class indi cafes an attempt to remove an 
Attribute that was denned by the row data Item (cither by reflection era 
Translator.) Only additional Attributes added'to LeifDataltems can be removed. 
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conijtU.leir.ire 

Interface InfoModel 

Ail Super-interfaces: 

B ea nCoqtextCft H dOwner, BeanCQntcxtChildQ^ncrDelceator. BeanContextProxy 

AH Known Implementing Classes: . ■ 

InfoMbdclSubset 



public interface InfoModel . 
extends MaDCj?D^CnildQjvoerPj?!«gitQr . • 

The InfoModel interface is the interface that is used to convert raw data items into Lei fDatat terns. The InfoModel should 
hold each of these LeifDataltems created using weak references so that the data items can be cleaned up when they arc no 
longer being used. //FENDtNG(RK): Any method marked with -PENDING" in the JavaDoc will likely be removed 
before LEIF is released in final form. 

Since: 

LEIF 4.0 • 
Version: 

^Revision: 1 .20 S, SDate: 2001/08/17 00:54:54 $ 
Author: 

David Alnulli * 



Method Summary 


void 


activateQneOfNServicatObiect service 1 

//PENDrNG(RX): This method will probably be removed from InfoModel! Notify the InfoModei 
that the given service is the preferred service of its type, and that this particular object should be returned 
if its class is requested, until removed or until another object of the same type is passed to a future call to- 
rtus method.' 


void 


addlnfoMo^elListenertlnfoModelLiatener listened 


Adds a listener to this InfoModel so that the listener will be informed of changes to the InfoModei. 


«old 


addOneOfKServiea (Object service) 

//PENDfNG(RK): This method will probably be removed from InfoModel! Add an object as a 
service to be retrieved by a call to getServiceQ (via BeanContext APIs) on any class that this object 
implements or extends. 


*oid 


qleax-Selectioa ( ) 

Clears the selection. 


u 


dvzna( ) 

Gives a list of all the LeifDataltems currently in the InfoModel. 




cietE r Contexts } 

Gets an EZ Context that corresponds to this InfoModel so the developer can use the E2 APIs. 
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gatU? i f^afeal teas ( 1 o ng ui d ) 

This will attempt to lookup a LtifDataliem from an id. 


Lei f Oa ' a I - tn 


S*tieifOafcaIteatgkj££i rawDacaltem) 

This will wrap a rawjava Objeet with a LeifDataitem wrapper so you dan use it in leif as.a data 

Item. 




gefciei^T)^^|t^{Q&i£££ rawDatalteto, booieaa create) 

This will wrap a raw Java Object with a LeifDaialtem wrapper so you can use It in leif as a data 
item. • . 


n 


g atLQigQat*r.bamg (Object, I ) rawOataltema 1 

This convenience method will wrap an array of raw java Objects- with LeifDataUem wrappen so : 
you can use them in feif as LeifDataltems. 




get?CkxantIn£"oi^od.&J. ( ] • 

Provides access to the parent lnfoMcdel that this InfaMode! delegates to. 


CSUSSZLil 


aetSelectedRawQataltems {J 

Gees the list of all the currently selected items for this lafeMDdel 




Get the selected raw data item, if only ona 


JO*S»itiatt 


Gets the ViewHost that this mfcModel is associated with. 


void 


remove InfoMod&IL is barter < I rtf aMod&lXlgtanar listeria r) 

Remotes a listener torn this bfoModcJ so that the listener will no longer be informed of changes 
to the InfoModeL 


void 


r«»ovoOnaOjgBrSarTlc<i (Object sarvica) 

//PENDINGfRK): This method will probably be removed from InfoModelf Remove an object that 
was a service to be retrieved by a call to getServiceQ (via BeanContext APIs) orf my eUs* that this 
objea implements or extends. 



Methods inherited from interface com.xis. beans. bea neon tcxL BennContextChtldOw-rierDclega tor 



Methods inherited front interface com^is^ean^beancontexL BeaoContextC hHdQwner 
g«bQy^«daqariCcatQxtChi.ld 



Methods inherited from interface iava.beflns.beancontextBennCon tcxtProxy 



Method Detail 



gerLeiiDataltem 

public Ley^Da calCgrn getXelfDatal tarn (long uldj 

throws OaralcemNotroijnriSxegoclcn 

This will anempt to lookup a LeifDataltem from an id. If the UED is invalid or there isn't a LeifDataltem that 

already exists with that given UID, an exception will be thrown. 

Parameters: 

utd - the unique Id for the raw data item. 
Returns: 
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the LeifDataltero with the given UID 



getLcifDatalfem 

public tifiiiQAM-Ues ffetLeifDafcaItea(Qhiact -raw Data Item) 

This will wrap a raw Java Object with a'LeifDatattem wrapper so you can use it in tetf as a data item- 
Parameters: 

rawDa tal tea ♦ the raw data that will be wrapped (Note: this should not already be a Lei/Data J 'leat) 
Returns: 

die wrapped data item. 



"etUifDataltem 

public l&iQ&tAltsa 0«tLeifDat^It&m (Qhj^Ct ravDataltem, 

booleaa create) 

This will wrap a raw Java Object with a LcilDataJtcro wrapper so you can use it in Icif as a data item. 
Parameters: 

rowOata tteit - the raw data that will be wrapped. (Note: this should not already be a Lei/Dtrteftcmf 
create - if false and ihe LeifDataltem is net already in the model, dont create one and return null 
. Returns: 

the wrapped daca item, or null if "create" is false and not found 



getLeifDataXtems ; 

public hel fp fl'taicem r 1 cretLelfData I cems ( Object I 1 rawOataltaas) • 

This convenience method wtU wrap an array of raw java Objects with LeifDataitem wrappers so you can use diem 
in leif as LeifDataitc ms. Nctc that you can get an array of raw data Hems often from methods like getMcmbersO, 
so this is a useful method to have. 
Parameters: 

rawDataltema - the raw data objects that will be wrappcl (Note? ihe objects should not already be 
Ui/Datalitms) 
Returns; 

the corresponding" wrapped data item array. 



A getEzContext 

public EzConEeXt gotXiContaxtn 

Gets an EZ Context mat corresponds to this info Model so the developer can use the EZ APU. 
Returns: 

the ez context for this info model 



getStDgleSelectedltem 

public Ob 1 act gatSingloS-oiactadrtoaO 
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Get the selected- raw date item, If only one. Else return null. 
Returns: 

the .selected item if there is only one. 



getParentlnfoMode! * 

public Infotfodal getPacantlafoHodain 

Provides access to the parent InfoModel that this InfoModel delegates to. If there is no parent modci th,en this will 

return nutL 

Returns: 

the parent InfoModel 



clear-Selection 

public void clo*txa«i«Btion{) 
Clears the selection. 



getSetectedRawDataltems 

F^lic Object H gatSeXectft^iRawDataiteast) 

Gets ihe list of all the currently .selected items for this InfoModel 
Returns: 

all of the selected data items (as raw data items) 



activateOueOCNService 

public void acfcivateOneOraServical Ohlect service) 

//PENDIKG(RK): This method will probably be removed from InfoModel! Notify the InfoModel that the given 
service is the preferred service of its type, end that this particular object should be returned if its class is requested, 
until removed or until another object of the same type is passed to a future call to this method. 

Parameters: 

service - (he object to become the preferred service 



addOneOfNScrvice 

pu&Uc void addOnaOfHSacvictt { Object aarvicej 

//PENOENG(RK): This-method will probably be removed from InfoModel! Add an objecLas a service to be 
retrieved by a call to getServiceQ (via BeanConte*t APIs) on any class thai this object implements or extends. 
• Parameters: 

service - the object to be returned when requested 
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remoYeOneOfNService 

public void reooveCn©ofw5arvico(S^Jss^ service) 

//PENDfNG(RK): This method will probably be removed from [nibModel! Remove an object that was t service to 
be retrieved by a call to eetSerricc{) (via BeanCcntcxt APIs) on any clau that this object implements or extends. 
Parameters: 

ae t vies - die object to be removed from service 



getVtew.Host * 

public ViswHssJ: gatViewHoat I ) 

• Gets tiie ViewHost that this InfoModel is associated with. If this InfoModel is not associated with a Viewrrlost then 
this will return null. * 

Returns: v 
the view hosfthat is maintaining this (nfc Model 



addlnfaM odelListener 

public void addlnfoModeiLls terror < tn f oNode lLlatana r listener! 

Adds a listener to this In&Model so that the listener will be w formed of changes to the InfoModel. 
Parameters; 

listener - the listener to add 



reraovelnfoModeiLCstener 

j 

public void reaoveInfoModalLi.staner<InfcHodelLi3eenar listener) 

Removes a listener from this InfoModel so that the listener will no longer be info/med of changes to the 
InfoModeL 

Parameters: * 
listener - the listener. to remove 



dump. 

public LelfEatrtlte.Ti n dump {> 

Gives a list of all the LelfDataltems currently in the* InfoModel. It Is highly recommerided to use this method only' 
if you absolutely have ao other way of accomplishing the task you need to da Please keep in mind that if you hold 
onto the LetfData Items contained in the array returned or If you hold onto the array itself, the items will not be 
removed from InfoModel until you release them. If you wish to hold onto mem, you should wrap them in 
WeafcReference objects. 

Nole: When you use the dumpQ method in combination with the addlnfoModellisUmr so that you can keep track 
of the same set ofLeJ/DaiaJtems as the InfoMqdei you can synchronize on the InfoModel lo get ihe dump and 
then add a listener to receive events of future changes. 



WO 02^46916 



75/90 




Example: 

synchronised UnfoModel) ( 

LeifDataItem[ 1 dataltems =» infoModel .dmspU ; 
inf oModei . addlnfoMode 1 listener [this] ; 
for lint i-0; i < data Items . length; ( 
process icera Ida tar terns (ij J ; 

)• 



Returns: 

the list of LeifDalal terns currently in the InfoModel. 
See Abo: 

Wftahfrsfsrence 
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Package com.ads Jeif.event 



This package contains classes for handling events in XIS. 
See: 

Description 



Interface Summary 


InfoModeLListener 


The infoModelListenex is used to monitor changes to an IrifoModeL 


LeifbataltemListener 


This class is used for listening to LeifDataltems for various events. 



Class Summary 


AttributeChangedEvent 


An " AttributeChanged" event gets delivered whenever a data item 
changes an attribute value. 


ContainerAddedEvent 


A "ContainerAdded" event gets delivered whenever a data item is 
contained as a member in anew object i 


ContainerRemovedEvent 


A ''ConteinerRemoved" event gets delivered whenever a data item has 
been removed as a member from a containing object. 


DataltemReplacedEvent 


The DaialtemRepJacedEvent class is used to indicate member changes 
of a containing data item. 


InfoModeJEvent 


The InfoModelEvent gets delivered whenever a LeifDataltem is created 
by the InfoModel; or when a LeifDataltem has been "lost" 'by the 
InfoModcL 


InfoModelEventSupoort 


The rnfoModeiEventSupport support class provides basic support for 
managing listeners on an ir.f oModel. 


LeifDataltemAdapter 


The LeifDataltemAdapter class provides support for setting up a 
LciiDataltcrnListcnci on a data item. 


LeifEyentSupport 


This is a utility class for XES developers to use when they want to fire 
event changes. 


MemberAddedEvent 


The MemberAddedEvent class indicates that members were added to 
this data item. 


MemberEvent 


The MemberEvent class is used to indicate members changes of a 
containing data item. 


MemberRemovedEvent 


The MemberRemovedEvent class indicates that the members are being 
removed from the containing data item. 


ReferenceAddedEvent 


The ReferenceAddedEvent class indicates that LeifReferences were 
added to the LeifDataltem. 


ReferenceEvent 


The References vent class indicates changes to the LeifReferences of 
the data item. 
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ReferenceReraovedEvent 


The ReferenceRemovedEvent class indicates that LerfReferences were 
removed from the LcifDataltem. 


ReferrerAddedEvent 


The ReferrerAddedEvent class indicates that a Refeirer was added to 
the data item. 


ReferreyRemovedEvent 


The RefeiTerRemovedEvent class indicates that a Rcfcrrer was 
removed from the data item. 



Package com.xis.leif.event Description 

This package contains classes for handling events in X1S. 
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1 : addRawDafcltem 
. > 



3 : newO 



4 : addLeifDgtaltemUstenerO 



5 : interrogate &et Attributes, etc) 



if 



3 

5- 



Figure 36C 
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PBla sourca <DS1, etc) 



InfoBsan 




infoWodel. 




LeflQataitem 



1 : Data updated 



2: property change event 




3:attrlbuteChanged 



4 : atiriljmteChanged 




5 ; seJtAttrlbuieO 



Figure 36D 
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Figure 37A 

TestHarness.java 



r XIS Tutorial standalone sequence example 5 XIS interfacing. 7 

import javax.swing JFrame; 

import javaawt event WindowAdapter; 

import java.awtevent.WindowEvent; 

/*r; 

import java.awt.GridLayout; 

import java.awtToolkit; 

import java.awtDimension; 

import java.awteventComponentAdapten 

import java.awteventComponentEvent; 

import javax.swing JSplitPane; 

import javax.swing JComponent; 

ryi 

import jdass.chart. JCChart; 

import com^dsJeif im.BaselnfoModel; 

import coraxis.plotPlotinfoBean; 

import com.xis.plotchartviews.LeifChartView; 

/*{*/ " 

import com.xis.table.TablelnfoBean; 

import coraxis.tree.TreelnfoBean; 

n*t 

public class TestHamess { , 

public static void main(StringQ args) { 

//the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaseInfoModeI.setStartingPIug!nManager(fa!se); 

/*{*/ 

HelloWorid hellol = new HelioWorld("First HelloWorld object/); 
HelloWorld hello2 = new HelloWorldrSecond HelloWorld object.*'); 
HelloWorid hello3 = new HelloWoridOThird HelloWorld object."); 
HelloWorid hello4 = new HeIloWoiid("Fourth HelloWorid object"); 
HelloWorld hello5 = new HelloWoridfFifth HelloWorid object"); 
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Figure 37B 

Continuation of TestHarness Java 

ObjectO helloArray = new ObjectQ { hellol , he!lo2, helIo3, heDo4, 
helloS}; 

I) create table and plot infobeans to display HelloWorid objects , 
TablelnfoBean table = new TablelnfoBean(); 

ryi 

PlotlnfoBean plot = new RotlnfoBean(); 
plotsetChartType(JCCharLBAR); 

//the alternatives are SCATTER_PLOT, PLOT, AREA, PIE, CANDLE, 
// and STACKING_BAR, though not all will make sense in this example 

// We can set the attribute for initial display on the plot; 
// see step 3 for further comments. 
plotsetYAxisAttribute( 

-com.xis.domains.movementlVlovementDomain.speed"); 
plotsetDynamicAdiustment(true); // so axes track value magnitude 
p!otsetBarChartAdjustfng(true); // needed in some cases for bar chart 

/*{7 . 

// a top-level frame as before to hold both plot and table side-by-side 
JFrame tablePlotFrame = new JFrame(HelloWorid(s) Table/Plot"); 
// use a repaired JSplitPane (see below) to manage the two beans 
SaneJSpIitPane splitpane = new SaneJSpIitPane(tabIe,plot, 
new Dimension(tabIe.getPreferredSize(). width + 
plotgetPreferredSizeQ.width, 
Math.min(tabte,getPreferredSize(). height, • 
plotgetPreferredSizeO-width)), 

0.50); 

tabIePlotFrame.getContentPane().add(splitpane); 

tablePlotFrame.pack(); 

tablePlotFrame.setVisible(true); 

// a tree infobean to display our HelloWorid objects 
TreelnfoBean tree = new TreelnfoBean( B HeiioWorld(s) Tree"); 
tree.addRawDataltems(helloArray); 

// a top-level frame to hold our tree infobean 

JFrame treeFrame = new JFrame( M HelloWorld(s) Tree"); 
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Figure 37C 

Continuation of TestHamessJava 

// avoid placing the windows on top of one another if we can 
int cutoffHeight = 424; 

If (Toolkit.getDefeiultToolkit().geecreenSize(),getHeight() > 
cutoffHeight +.200) { 

treeFramasetLocation(348,cutoffHeight+7); 

} 

7 

// add a listener for window closing 
treeFrame.addWindowListener( 
new WindowAdapterQ { 

public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

> 

); 

// stick the tree infobean in the frame and display it 

treeFrame.getContentPane0.add(tree); 

treeFrarne.packO; 

treeFrame.setVisible(true); 

} // main 



r 

* This class overrides the default JSplitPane to provide a reasonable 

* resize behavior maintain the left and right panels in the same 

* proportions. 
7 

public static final class SaneJSplitPane extends JSplitPane { 

private int lastWidth; 
private double lastDividerProp; 

public SaneJSp!itPane(JComponent leftComponent, 
JComponent rightComponent, 
. Dimension dims, double startProportion) { 
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Figure 37D 

Continuation of TestHarnessjava 

superCJSplitPane.HORIZONTAL^SPLIT, 

leftComponent, rightComponent); 
setSize(dims); 

// Since the JSplitPane doesnH set the lastDMdertocation 
// variable, nor does it provide any other easier way to maintain 
// the split proportion on resize, we must track the divider 
// location ourseff. 
lastWidth * dims.width; 
lastDividerProp = startProportion; 
setDividerLocation(startProportion); 

// this listens for resize events on the splitpane and makes sure 
// we keep same split proportions 
addComponentListener(new ComponeniAdapter() { 

public void componentResized(ComponentEvent event) { 
setDividerLocation(lastDividerProp); 
lastWidth = (int)eventgetComponent(). 
getSize().getWidth{); 

}}): 

// only way to know if divider moved by user is to listen for 
// resize events on the components; this isn't foolproof (since 
// resizes can come from other sources) but it works well enough 
IeftComponent.addComponentListener(new ComponentAdapter() { 
public void componentResized{ComponentEvent ev^nt) { 
// we add in getDividerSize() / 4 to compensate for a 
// bug In JSplitPane which doesnl take account of the 
// divider width in location-proportion conversions 
lastDividerProp = (double)(getDividerLocation() + 
(getDividerSize() / 4)) / lastWidth; 

}}); 



} 
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Figure 38 A 



HelloWorldfs) Tree 



f- £3 First HelloWorld object 
f"- E3 Second HelloWorld object 

£3 Third HelloWorld object 
f" Fourth HelloWorld object 
•■• Fifth HelloWorld object 



Figure 38B 
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Figure 38C 
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com.xis.leifam 

Interface AttributeAlias 



public interface AttributeAlias 

The AttributeAlias indicates an alias from 1.& Attributes to a single Attribute, together with a 
precision level; the higher the precision, the better the alias. The alias allows a caller to query for one 
of the 1. ji "from" attributes and get the value stored by fee data item under the "to" attribute, possibly 
mediated by some conversion, such as a units transformation. 

If the converted or calcuated value cannot be determined, then the Attributefrgetvalue ( ) method 
should throw an Unconva g t ib l oAiia s Except ion This Exception is a subclass of the 
Ondef inedLei f At t ribut eExceot i on which is typically thrown by normal Attributes in this case, 
and it can provide a descriptive message indicating the source of the incompatibility. 

'The utility of attribute aliases may be seen by considering the following example: . 

The user has performed a query from an external data source and retrieved a set of Airfields, indexed 
by an ICAO identifier. The user now wanti to get the list of Aircraft at one of the airfields. There is a 
local aircraft database with a foreign key field for Airfields, but that key is a WAC identifier, not 
ICAO. ^ 

Assumption: The application was NOT written ahead of time to know about these two databases or 
their ID types, Instead, what you have is an XIS "Leif Dataitera" for the Airfield, and you have an . 
XIS InfoBean for the Aircraft query form. ' 

What you want to do is to copy (or "drop") the Airfield data item into the "WAC" field in the query, 
form. In doing this, the Form will ask the data item for its "WAC" attribute* (because this is all it 
knows about). It uses the "getWAC ( 1 " method from some domain (say, the Airf ieidDomain). 

The way this could work is that there would have to be an AttributeAlias defined to convert ICAO 
to WAC - or, more specifically, Aviation Domain .ICAOtO Airf ieidDomain, WAC. The 
AttributeAlias returns an Attribute object that knows how to transform ICAOs to WACs (e.g., 
by accessing a conversion table). The Attribute, in turn, has a getvalue ( ) method to execute that 
. transformation and return the WAC. 

This process would be entirely transparent to the user, or even the caller, who would just see a result 
returned from the getWAC ( ) method. In cases where the conversion was not possible, the 
UnconvertibleAliaaException would.be thrown, possibly providing informative iirfonnatiori to 
the caller or user,- 

Finally, note that due to the way the mechanism is set up (using resources and a PluaoaMeServicel . 
this AttributeAlias can be installed as a separate module without requiring any re-coding or re- 
compilation of the existing application. 
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Method Summary 




aetAliasedProm (J 


i CI 


.This indicates which AttributeDescriptors (which in turns means which 
Attributes) arc required for the alias. 


fttcxLtJuteQfiacrioCQr 


qetAJLiasodTo ( ) 

This indicates the AttributeDescriptor that this AttributeAlias is for. 




getAttr Abate ( ) 

. Get the Attribute object that is the alias Attribute. 


Int. 


getPrecisionPrior-i ty ( ) 

This indicates the precision of the AttributeAlias. 



Method Detail 



getPrecisionPriorlty 

public int getPrecisionPriorlty () 

This indicates the precision of the AttributeAlias. The higher the number the better the alias. 
This number is used to determine which AttributeAlias to use when there are more than one 
alias for a given Attribute. 
Returns: 

the precision of the alias. 



getAliasedFrom 

public AttributeDescriptor H getAliasedFrom ( } 

This indicates which AttributeDescriptors (which in turns means which Attributes) are required 

for the alias. - 

Returns: 

the list of descriptors required for this alias. 



getAUasedTo 

public At;trjbut;ePegpriptor getAliasedTo ( } 

This indicates the AttributeDescriptor that this AttributeAlias is for. 
Returns: 

the descriptor that this alias is for. 
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getAttribute 

public Attribute getAttribute ( ) 

Get the Attribute object that is the alias Attribute. This attribute is responsible- for performing 
the translation from the aliased from Attributes. The AttributeDescriptor of the Attribute 
MUST be the same AttributeDescriptor returned by gctAliasedTo. 
Returns: 

the attribute that will do the translation. 



Ff«, 31C 



WO 02/46916 



90/90 



PCT/US01/48418 



-4000 



CPU 



4002 



DASD 



4008 



MEMORY 



4010 



NETWORK 
INTERFACE 



4018 



DISPLAY 



4006 



KEYBOARD 
MOUSE 



4004 



PROGRAM 
PRODUCT READER 

4012 



4016 



4020 



4014 



j=L 



NETWORK 



Figure 40 



